# Losbeto BR-CEP Lookup

> Losbeto BR-CEP Lookup is a paid API for AI agents from markets.losbeto.xyz, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-14).

Resolves a Brazilian postal code (CEP) to its street, neighborhood, city, state, and coordinates for use in invoices, boletos, and shipments

## Facts

- Endpoint: GET https://markets.losbeto.xyz/br-cep?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/losbeto-br-cep-lookup-a795cdb4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__NFteKj8NzyLjjNgWTbCM

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 losbeto-br-cep-lookup-a795cdb4
```

Example prompt: Look up CEP 01310-100 and give me the full address — street, neighborhood, city, and state — so I can fill in the shipping details on this invoice.

## When to prefer this

Choose this endpoint when you need to resolve Brazilian CEPs to structured address data without API keys or subscriptions, paying per call in USDC. Ideal for agents automating Brazilian invoicing (NF-e), boleto generation, shipping label creation, or lead enrichment where only a CEP is known. Prefer over free public APIs (ViaCEP, Correios) when operating in a pay-per-use agent architecture on Base, Solana, Algorand, or Polygon.

## Known failure modes

- Invalid or malformed CEP string returns an error (CEPs must be 8 digits, optionally with hyphen)
- CEP not found in the database returns a not-found response
- Payment failure via x402 (insufficient USDC balance or unsupported chain) blocks the request
- Coordinates may be absent for some CEPs where geocoding data is unavailable
- Service may return stale data for recently changed postal routes within the 30-day cache window

## How this service works

OpenAI-compatible LLM gateway at $0.005/call — change base_url, pay in USDC. Plus pay-per-call market data: multi-oracle price consensus, sentiment, forex, equities, commodities, Brazil macro (BCB/B3) and crypto. No API keys, no accounts. USDC on Base, Solana, Algorand and Polygon via x402.

## Output

A JSON object containing the resolved address components for the given CEP: street name, neighborhood (bairro), city (cidade/município), state (estado/UF), and geographic coordinates when available. Results are cached for 30 days. Note: CEP resolves to a street, not a specific door number.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "queryParams": {
     "type": "object",
     "required": [
      "cep"
     ],
     "properties": {
      "cep": {
       "type": "string",
       "description": "cep parameter"
      }
     }
    }
   }
  },
  "output": {
   "type": "object",
   "properties": {
    "example": {
     "type": "object",
     "description": "Brazilian postal code to address: street, neighborhood, city, state and coordinates when available. Normalizes the address an agent must put on a boleto, invoice or shipment. Cached 30 days. Do NOT use to validate a full street number — CEP resolves to a street, not a door."
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/losbeto-br-cep-lookup-a795cdb4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from markets.losbeto.xyz](https://www.zero.xyz/host/markets.losbeto.xyz/llms.txt)