{"uid":"cap__NFteKj8NzyLjjNgWTbCM","slug":"losbeto-br-cep-lookup-a795cdb4","name":"Losbeto BR-CEP Lookup","description":"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.","url":"https://markets.losbeto.xyz/br-cep?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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."}}}}},"responseSchema":{"type":"json"},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_MRI3XqKjd36jg-uX-EjsK","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Resolves a Brazilian postal code (CEP) to its street, neighborhood, city, state, and coordinates for use in invoices, boletos, and shipments","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Autofill boleto billing address","prompt":"I have a customer's CEP 04538-133 — can you look it up and give me the street name, neighborhood, city, and state so I can fill in their billing address on the boleto?"},{"title":"Normalize e-commerce shipping address","prompt":"Before I ship this order, look up CEP 30130-110 and return the full street and city so I can confirm the address on the label is correct."},{"title":"Enrich lead data with location info","prompt":"I've got a list of Brazilian customers with only their CEPs — can you start with 20040-020 and tell me the neighborhood, city, and state it maps to?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T12:30:03.627Z","isFirstParty":false,"canonicalSlug":"losbeto-br-cep-lookup-a795cdb4"}