# BR Data API for agents

> Normalized Brazilian public data. Paid endpoints use x402 (HTTP 402 + USDC on eip155:8453); no signup.

## Free trial
Try before you pay: the first call of each paid tool per client IP per UTC day returns real data free (response includes a `_free_trial` note). MCP: automatic on tools/call. REST: add header `X-Free-Trial: 1` (or `?free_trial=1`). After that the endpoint answers 402 / x402 PaymentRequirements; pay with an x402 client (e.g. @x402/fetch + viem) — USDC on Base, no ETH needed (EIP-3009).

## Endpoints
- GET /v1/cnpj/:cnpj — Brazilian company (CNPJ) registry lookup from Receita Federal open data, normalized: legal/trade name, status, CNAE activities, address, Simples/MEI, partners (QSA). Supports alphanumeric CNPJ. Price: $0.01.
- GET /v1/rates/selic — Current Brazilian policy rate (Selic target set by Copom), effective daily Selic and CDI, annualized, from Banco Central do Brasil. Price: $0.005.
- GET /v1/rates/ipca — Brazilian official inflation (IPCA, IBGE via BCB): latest monthly change, 12-month accumulated, and monthly history. Price: $0.005.
- GET /v1/rates/ptax — Official PTAX exchange rate (BRL per unit of foreign currency) published by Banco Central do Brasil for a given date; falls back to the last bulletin before a weekend/holiday. Price: $0.005.
- GET /v1/business-days — Brazilian business-day calculator (national + banking holidays): count business days between two dates (DU convention, (from, to]) or add N business days to a date. Price: $0.005.
- GET /v1/banks/:query — Brazilian bank / payment institution lookup by COMPE code, ISPB, CNPJ or name, merged from Banco Central's STR participant list and active Pix participant list. Price: $0.005.
- GET /v1/cep/:cep — Brazilian postal code (CEP) to address: street, district, city, UF, IBGE city code, DDD. Price: free.
- GET /v1/holidays/:year — Brazilian national and banking holidays for a year (incl. Carnival, Good Friday, Corpus Christi, Nov 20). Price: free.

OpenAPI: https://brasil-data-x402.wagner-proc.workers.dev/openapi.json
MCP (Streamable HTTP): https://brasil-data-x402.wagner-proc.workers.dev/mcp