{
  "service": "Brazil Business Days & Official FX (PTAX)",
  "description": "Public Brazilian calendar and official Central Bank PTAX FX for software agents. Business-day checks include national holidays, state holidays, calculated Easter/Carnival/Corpus Christi, and an ANBIMA-style calendar. FX quotes come from the Banco Central do Brasil PTAX API, cached, with ODbL attribution. No CPF lookup. Price is 0.005 USDC on Base per paid call.",
  "version": "1.1.0",
  "payTo": "0xd0fA603260Dc4Db99f4A5e1BAE2F73acDd6Ea386",
  "network": "eip155:8453",
  "asset": "USDC",
  "price_usd": "0.005",
  "price_atomic": "5000",
  "facilitator": "https://facilitator.payai.network",
  "timezone": "America/Sao_Paulo",
  "free_routes": {
    "GET /": "This service description (free)",
    "GET /health": "Liveness (free)",
    "GET /openapi.json": "OpenAPI 3.1 with x-payment-info (free)",
    "GET /llms.txt": "Agent-oriented documentation (free)",
    "GET /mcp.json": "MCP tool wrapper description (free)",
    "GET /.well-known/x402": "x402 resource index (free)",
    "GET /.well-known/api-catalog": "RFC 9727 API catalog (free)"
  },
  "paid_routes": {
    "GET /v1/business-days": {
      "price_usd": "0.005",
      "query": {
        "date": "YYYY-MM-DD, required unless year is set",
        "year": "YYYY, lists holidays and counts business days",
        "uf": "Optional two-letter state code (e.g. SP, RJ)",
        "calendar": "anbima (default) or national"
      },
      "notes": {
        "anbima": "Weekends, official national holidays, Carnival Monday and Tuesday, Corpus Christi, and state holidays when uf is set. Carnival and Corpus Christi are widely observed (ANBIMA-style) even when they are only facultative at the federal level.",
        "national": "Weekends and official national holidays only, plus state holidays when uf is set. Carnival and Corpus Christi are business days unless they are also a state holiday (Carnival Tuesday in RJ)."
      }
    },
    "GET /v1/fx/ptax": {
      "price_usd": "0.005",
      "query": {
        "date": "YYYY-MM-DD (required). No future dates.",
        "currency": "USD (default) or another BCB PTAX currency"
      },
      "currencies": [
        "USD",
        "EUR",
        "GBP",
        "JPY",
        "CHF",
        "CAD",
        "AUD",
        "SEK",
        "DKK",
        "NOK",
        "ARS",
        "CLP",
        "CNY",
        "MXN",
        "ZAR",
        "KRW",
        "SGD",
        "HKD",
        "NZD",
        "TRY"
      ],
      "license": "ODbL-1.0, source Banco Central do Brasil"
    }
  },
  "examples": {
    "business_days": "https://x402-br.coratech.workers.dev/v1/business-days?date=2024-12-25&uf=SP",
    "holidays_year": "https://x402-br.coratech.workers.dev/v1/business-days?year=2026&uf=RJ",
    "ptax": "https://x402-br.coratech.workers.dev/v1/fx/ptax?date=2024-12-20&currency=USD"
  },
  "docs": {
    "holidays": "National holidays follow federal law, including Black Awareness Day from 2024 (Lei 14.759/2023). Easter, Carnival and Corpus Christi are calculated. State holidays use published state laws; some states shift observance (Acre midweek holidays move to Friday; Santa Catarina dates are observed on the following Sunday). Municipal holidays are not included.",
    "payments": "Unpaid calls to paid routes return HTTP 402 with a PAYMENT-REQUIRED header (x402 v2). Pay in USDC on Base to the payTo address through the PayAI facilitator. Do not send seed phrases or private keys to this service."
  },
  "ok": true
}