# BR Data API – Bank/ISPB Lookup

> BR Data API – Bank/ISPB Lookup is a paid API for AI agents from brasil-data-x402.wagner-proc.workers.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-13).

Search Brazilian banks by name, ISPB code, or COMPE code and return normalized bank metadata

## Facts

- Endpoint: GET https://brasil-data-x402.wagner-proc.workers.dev/v1/banks/%7Bquery%7D?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/br-data-api-bank-ispb-lookup-767ece6e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_qyuyvJsxEDyMSIOQ6wTHu

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability br-data-api-bank-ispb-lookup-767ece6e
```

Example prompt: What's the ISPB code and COMPE code for Nubank in Brazil? Search for 'NU PAGAMENTOS' in the Brazilian banks database.

## When to prefer this

Choose this endpoint when you need to resolve Brazilian bank identifiers (ISPB or COMPE codes) from a name or code fragment, especially in fintech workflows involving PIX transfers, TED/DOC payments, or bank account validation. Prefer this over scraping Banco Central's website or maintaining a local bank list, as it provides clean normalized data on demand with no API key required, only a small USDC micropayment via x402.

## Known failure modes

- No matching bank found for query — returns count:0 with empty results array
- Invalid or unrecognized query string yields empty results
- Payment required (HTTP 402) if USDC x402 payment header is missing or malformed
- Network timeout on Cloudflare Worker edge node
- Rate limiting or quota exhaustion returning HTTP 429

## How this service works

Clean, normalized Brazilian public data (CNPJ, CEP, BCB rates, PTAX, holidays/business days, banks/ISPB) for AI agents. Paid endpoints use x402 (HTTP 402, USDC) — no signup or API key. Not affiliated with Receita Federal, Banco Central or Correios.

## Output

Returns a JSON object with a count of matching banks and a results array, each entry containing the ISPB code, COMPE code, and short name of the matching bank(s). Example: {"count":1,"results":[{"ispb":"18236120","compe_code":"260","short_name":"NU PAGAMENTOS - IP"}]}

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "results": [
   {
    "ispb": "18236120",
    "compe_code": "260",
    "short_name": "NU PAGAMENTOS - IP"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/br-data-api-bank-ispb-lookup-767ece6e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from brasil-data-x402.wagner-proc.workers.dev](https://www.zero.xyz/host/brasil-data-x402.wagner-proc.workers.dev/llms.txt)