{"protocolVersion":"0.3.0","name":"Brazilayer","description":"Official Brazilian public data for AI agents: company registry (CNPJ), partners, sanctions and debarment, bank licenses (BCB), government contracts, investment funds (CVM), tax reform, deforestation alerts, commodities and market signals. Pay per call in USDC via the x402 protocol; no account, no API key.","url":"https://api.brazilayer.com","preferredTransport":"HTTP+JSON","provider":{"organization":"Brazilayer","url":"https://www.brazilayer.com"},"version":"1.0.0","documentationUrl":"https://api.brazilayer.com/docs","capabilities":{"streaming":false,"pushNotifications":false,"stateTransitionHistory":false},"defaultInputModes":["application/json"],"defaultOutputModes":["application/json"],"securitySchemes":{"x402":{"type":"openIdConnect","openIdConnectUrl":"https://api.brazilayer.com/.well-known/x402","description":"x402 v2: a 402 response carries the price in the payment-required header; retry with X-Payment (USDC on Base). Discovery document lists every paid resource."}},"security":[{"x402":[]}],"payment":{"protocol":"x402","version":2,"discovery":"https://api.brazilayer.com/.well-known/x402","openapi":"https://api.brazilayer.com/openapi.json","llms":"https://api.brazilayer.com/llms.txt","mcp":"io.github.brazilayer/mcp"},"skills":[{"id":"cnpj-situacao","name":"cnpj situacao","description":"Does this CNPJ exist in the official Receita Federal registry, and is it active? Returns existence, registration status (situacao_cadastral: Ativa=active, Suspensa=suspended, Baixada=closed) with date, headquarters/branch flag and state. Cheapest paid check in the catalog: digit arithmetic alone cannot tell a well-formed number from a real, active company. Free sample, no payment: https://api.brazilayer.com/v1/cnpj/amostra","tags":["brazil","x402","cnpj"],"examples":["GET https://api.brazilayer.com/v1/cnpj/situacao/00000000000191"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"cnpj-empresa","name":"cnpj empresa","description":"Official registration data for a Brazilian company from the Receita Federal (Brazilian IRS) CNPJ registry, updated monthly: legal name (razao_social), trade name, registration status (situacao_cadastral: Ativa=active, Baixada=closed), start date, legal nature, share capital, main and secondary CNAE activities with descriptions, full address, contact info and Simples/MEI tax regime flags. Keys are in Portuguese legal terms. Free sample, no payment: https://api.brazilayer.com/v1/cnpj/amostra","tags":["brazil","x402","cnpj"],"examples":["GET https://api.brazilayer.com/v1/cnpj/empresa/00000000000191"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"cnpj-empresa-socios","name":"cnpj empresa socios","description":"Partners and shareholders (socios) of a Brazilian company from the official Receita Federal CNPJ registry: partner name, type (individual/company/foreign), masked tax document (CPF comes pre-masked from the government source), role/qualification, entry date and age bracket. Useful for KYB and ownership checks. Free sample, no payment: https://api.brazilayer.com/v1/cnpj/amostra","tags":["brazil","x402","cnpj"],"examples":["GET https://api.brazilayer.com/v1/cnpj/empresa/00000000000191/socios"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"cnpj-empresa-completo","name":"cnpj empresa completo","description":"Complete bundle for a Brazilian company in one call: full registration data + all partners/shareholders + list of branches (filiais) with their status. Best value for a full company profile from the official Receita Federal CNPJ registry. Free sample, no payment: https://api.brazilayer.com/v1/cnpj/amostra","tags":["brazil","x402","cnpj"],"examples":["GET https://api.brazilayer.com/v1/cnpj/empresa/00000000000191/completo"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"cnpj-busca","name":"cnpj busca","description":"Search Brazilian companies in the official Receita Federal CNPJ registry. Filters (at least one required): nome (full-text on names, accent-insensitive), uf (state), municipio (4-digit RFB code), cnae, porte (size), abertura_de/abertura_ate (opening-date window YYYY-MM-DD, for newly registered companies), situacao (default \"ativa\"). Paginated; total capped at \"10000+\". Free sample, no payment: https://api.brazilayer.com/v1/cnpj/amostra","tags":["brazil","x402","cnpj"],"examples":["GET https://api.brazilayer.com/v1/cnpj/busca"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"integridade-consulta","name":"integridade consulta","description":"Sanctions and integrity screening for a Brazilian company (CNPJ) in ONE call, from official government registries updated daily: CEIS (debarred companies), CNEP (Anti-Corruption Law fines), CEPIM (nonprofits barred from federal agreements), the Labor Ministry slave-labor blacklist, and leniency agreements. Returns every match with category, authority, dates and legal basis, plus a clean-record flag. Free sample, no payment: https://api.brazilayer.com/v1/integridade/amostra","tags":["brazil","x402","integridade"],"examples":["GET https://api.brazilayer.com/v1/integridade/consulta/00000000000191"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"licitacoes-fornecedor","name":"licitacoes fornecedor","description":"Every public contract won by a Brazilian company, from the official National Public Procurement Portal (PNCP): contracting government body, object, value, signature date and validity period, plus summary stats (total contracts, total value, distinct bodies). The missing piece of due diligence: how much a company sells to the government. Company records only. Free sample, no payment: https://api.brazilayer.com/v1/licitacoes/amostra","tags":["brazil","x402","licitacoes"],"examples":["GET https://api.brazilayer.com/v1/licitacoes/fornecedor/00000000000191"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"licitacoes-abertas","name":"licitacoes abertas","description":"Live open tenders from the Brazilian government (PNCP): every procurement currently accepting proposals, with object, estimated value, contracting body, deadlines and the link to bid. Filter by modality (default: electronic auction) and state (uf). Queried live from the official source at request time — always fresh. Paginated. Free sample, no payment: https://api.brazilayer.com/v1/licitacoes/amostra","tags":["brazil","x402","licitacoes"],"examples":["GET https://api.brazilayer.com/v1/licitacoes/abertas"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"bcb-instituicao","name":"bcb instituicao","description":"Verify whether a Brazilian company is a financial institution authorized by the Central Bank of Brazil (banks, credit unions, consortia, regulated societies) — plus its officially VERIFIED internet domains, refreshed daily from the official registry. Instant check for crypto exchanges, fintechs and compliance agents onboarding Brazilian counterparties or detecting fake-bank phishing. Accepts full CNPJ or 8-digit root. Free sample, no payment: https://api.brazilayer.com/v1/bcb/amostra","tags":["brazil","x402","bcb"],"examples":["GET https://api.brazilayer.com/v1/bcb/instituicao/00000000000191"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"empresa-enriquecer","name":"empresa enriquecer","description":"Full KYB profile of a Brazilian company in ONE call — the enrichment bundle: official registration from the Receita Federal CNPJ registry (69M companies), partners/shareholders, branches, sanctions screening across 5 official government lists, Central Bank authorization with verified domains, and public contracts won (PNCP) with totals. Entity in, complete due-diligence profile out; replaces 5 separate calls. Free sample, no payment: https://api.brazilayer.com/v1/empresa/amostra","tags":["brazil","x402","empresa"],"examples":["GET https://api.brazilayer.com/v1/empresa/enriquecer/00000000000191"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"mercado-noticias","name":"mercado noticias","description":"Brazilian financial & crypto market news, refreshed every 15 minutes from major Brazilian outlets: headline, summary, link, topic (crypto, macro, fx, regulation, companies), investor sentiment and 0-10 market relevance. Brazil is a top-10 crypto adoption market — central bank moves, Drex (CBDC) and CVM regulation move prices. Filters: tema, sentimento, relevancia_min. Free sample, no payment: https://api.brazilayer.com/v1/mercado/amostra","tags":["brazil","x402","mercado"],"examples":["GET https://api.brazilayer.com/v1/mercado/noticias"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"mercado-indicadores","name":"mercado indicadores","description":"Brazil macro snapshot in one call, straight from the Central Bank: Selic policy rate, IPCA inflation (monthly and 12-month), official PTAX USD/BRL rate, plus the Focus survey — the market's median forecasts for inflation, policy rate, GDP and FX for this year and next, updated weekly. The essential context pack for any agent trading BRL pairs or emerging markets. Free sample, no payment: https://api.brazilayer.com/v1/mercado/amostra","tags":["brazil","x402","mercado"],"examples":["GET https://api.brazilayer.com/v1/mercado/indicadores"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"mercado-cambio","name":"mercado cambio","description":"USD/BRL two ways: the official Central Bank PTAX rate and the LIVE crypto market — BTC/BRL, USDT/BRL and the Brazil premium (ágio): how much Brazilians pay above global price for dollar/crypto exposure. A classic emerging-market capital-flow signal, computed live from exchange prices at request time. Positive premium = capital-flight pressure; discount = inflow. Free sample, no payment: https://api.brazilayer.com/v1/mercado/amostra","tags":["brazil","x402","mercado"],"examples":["GET https://api.brazilayer.com/v1/mercado/cambio"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"commodities-clima","name":"commodities clima","description":"Crop-weather stress for the Brazilian belts that price global commodities: 7-day observed rain, 7-day FORECAST rain, consecutive dry days and 72h frost risk for the coffee belt (ICE KC), soybean belts (CBOT ZS), sugarcane (ICE SB), corn, orange and cocoa regions. Brazil is the top exporter of coffee, sugar, soybeans and OJ — weather here moves those futures. Updated twice daily. Free sample, no payment: https://api.brazilayer.com/v1/commodities/amostra","tags":["brazil","x402","commodities"],"examples":["GET https://api.brazilayer.com/v1/commodities/clima"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"commodities-fogo","name":"commodities fogo","description":"Daily fire hotspots across Brazil from the official INPE satellite program: count and mean intensity (FRP) by biome (Amazon, Cerrado, etc.) over the last 7 days, leading states, plus mean days-without-rain at fire locations — a drought proxy. Signal for ESG screening, carbon markets, cattle and soy supply-chain risk. Free sample, no payment: https://api.brazilayer.com/v1/commodities/amostra","tags":["brazil","x402","commodities"],"examples":["GET https://api.brazilayer.com/v1/commodities/fogo"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"commodities-exportacoes","name":"commodities exportacoes","description":"Monthly Brazilian export volumes and FOB values for the commodities Brazil dominates: soybeans, corn, coffee, sugar, beef, chicken, cotton and pulp — from the official ComexStat registry, with year-over-year volume change per month. Brazil supply shifts move CBOT and ICE prices; this is the official record of what actually shipped. Free sample, no payment: https://api.brazilayer.com/v1/commodities/amostra","tags":["brazil","x402","commodities"],"examples":["GET https://api.brazilayer.com/v1/commodities/exportacoes"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"commodities-hidrologia","name":"commodities hidrologia","description":"Brazil stored hydro energy (EAR) by grid subsystem, daily from the official grid operator (ONS), with 7-day delta. Brazil is hydro-dependent: reservoir levels drive power prices, aluminum/industrial costs and drought narratives. A compact energy-risk gauge for one of the world largest grids. Free sample, no payment: https://api.brazilayer.com/v1/commodities/amostra","tags":["brazil","x402","commodities"],"examples":["GET https://api.brazilayer.com/v1/commodities/hidrologia"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"commodities-briefing","name":"commodities briefing","description":"Today's Brazil Commodity Briefing, in English, synthesized daily by AI from official Brazilian public data: crop weather and frost risk, fire/drought, export flows, hydro levels, FX and market headlines — condensed into what changed and what to watch for coffee (KC), sugar (SB), soybeans (ZS), corn (ZC), OJ, cotton and cattle, with per-commodity bullish/bearish flags. Free sample, no payment: https://api.brazilayer.com/v1/commodities/amostra","tags":["brazil","x402","commodities"],"examples":["GET https://api.brazilayer.com/v1/commodities/briefing"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"fundos-fluxos","name":"fundos fluxos","description":"Where Brazilian institutional money moved today: daily net flows (subscriptions minus redemptions) by fund class — fixed income, equities, multi-strategy, FX — across the entire R$ 13.8 trillion Brazilian fund industry, from official CVM filings covering ~25,000 fund classes. The emerging-market equivalent of smart-money netflow, from the regulator itself. Free sample, no payment: https://api.brazilayer.com/v1/fundos/amostra","tags":["brazil","x402","fundos"],"examples":["GET https://api.brazilayer.com/v1/fundos/fluxos"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"fundos-consulta","name":"fundos consulta","description":"Verify a Brazilian investment fund by CNPJ against the official CVM registry: is it registered, is it operating, who is the manager (gestor) and administrator, its class and ANBIMA classification — plus the latest daily NAV, net assets and shareholder count. The instant check against fake-fund and Ponzi schemes marketed as investment funds. Free sample, no payment: https://api.brazilayer.com/v1/fundos/amostra","tags":["brazil","x402","fundos"],"examples":["GET https://api.brazilayer.com/v1/fundos/consulta/00000000000191"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"fundos-ranking","name":"fundos ranking","description":"Rank and screen Brazilian investment funds from official CVM data: largest by net assets, biggest net inflows over a window, or most shareholders — filterable by class (Renda Fixa, Ações, Multimercado, Cambial). Returns fund name, manager, administrator, NAV, assets and flows. Fund screening over the whole R$ 13.8tn industry. Free sample, no payment: https://api.brazilayer.com/v1/fundos/amostra","tags":["brazil","x402","fundos"],"examples":["GET https://api.brazilayer.com/v1/fundos/ranking"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"fundos-carteira","name":"fundos carteira","description":"A Brazilian fund's equity holdings from the official CVM portfolio disclosure (CDA): every stock/BDR it holds in its latest disclosed month — ticker, quantity, market value, and how much it bought and sold that month. Disclosure is per-fund and lagged up to 90 days by law; funds with no equities do not appear. Free sample, no payment: https://api.brazilayer.com/v1/fundos/amostra","tags":["brazil","x402","fundos"],"examples":["GET https://api.brazilayer.com/v1/fundos/carteira/00000000000191"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"fundos-movimentacoes","name":"fundos movimentacoes","description":"What Brazilian funds are buying and selling, stock by stock, from the official CVM portfolio disclosure (CDA): for the latest consolidated month, the amount bought and sold per ticker across all disclosing funds, and the net flow — the institutional \"smart money\" signal per Brazilian stock. Defaults to the most recent month with broad disclosure. Free sample, no payment: https://api.brazilayer.com/v1/fundos/amostra","tags":["brazil","x402","fundos"],"examples":["GET https://api.brazilayer.com/v1/fundos/movimentacoes"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"tributos-ncm","name":"tributos ncm","description":"Which IBS/CBS regime applies to a product, by NCM code, under Brazil's tax reform (LC 214/2025): zero rate, 60% reduction or standard — with the LEGAL BASIS returned (annex, item and the literal wording of the law) plus what taxes are in force this year of the 2026-2033 transition. Brazil is replacing 5 taxes; every seller and every buying agent must reclassify. Free sample, no payment: https://api.brazilayer.com/v1/tributos/amostra","tags":["brazil","x402","tributos"],"examples":["GET https://api.brazilayer.com/v1/tributos/ncm/10064000"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"tributos-busca","name":"tributos busca","description":"Search Brazil's tax reform annexes by product or service description and get every entry that grants a reduced or zero IBS/CBS rate, with the NCM codes cited, the annex, the item and the literal legal wording. Answers 'does what I sell get a tax break under the new Brazilian VAT?' without reading 900,000 characters of law. Free sample, no payment: https://api.brazilayer.com/v1/tributos/amostra","tags":["brazil","x402","tributos"],"examples":["GET https://api.brazilayer.com/v1/tributos/busca"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"tributos-calendario","name":"tributos calendario","description":"Brazil's tax transition calendar, year by year from 2026 to 2033: which taxes are in force each year, at what rate, and when PIS/COFINS, IPI, ICMS and ISS are extinguished. The context an agent needs to know whether the tax rule it used is still valid on the date of the transaction. Free sample, no payment: https://api.brazilayer.com/v1/tributos/amostra","tags":["brazil","x402","tributos"],"examples":["GET https://api.brazilayer.com/v1/tributos/calendario"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"cadeias-energia-br","name":"cadeias energia br","description":"Causal chain for Brazilian power risk: forecast rainfall over the Southeast/South (leads reservoir levels by ~2-4 weeks) → stored hydro energy per subsystem and its 7-day slope, from the grid operator → likelihood of thermal dispatch and cost pressure. Brazil runs on hydro: this is the upstream of industrial energy cost, and the rule and its limits travel in the response. Free sample, no payment: https://api.brazilayer.com/v1/cadeias/amostra","tags":["brazil","x402","cadeias"],"examples":["GET https://api.brazilayer.com/v1/cadeias/energia_br"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"cadeias-cafe-kc","name":"cadeias cafe kc","description":"Causal chain for arabica coffee: minimum temperature forecast 72h ahead over the southern Minas belt (frost is the event that historically moves KC hardest, operational threshold 3 °C) → consecutive dry days stressing flowering → observed rainfall → the official BRL/USD rate that converts the international price for the grower. Brazil is the top arabica exporter. Physical signal only — bring your own price. Free sample, no payment: https://api.brazilayer.com/v1/cadeias/amostra","tags":["brazil","x402","cadeias"],"examples":["GET https://api.brazilayer.com/v1/cadeias/cafe_kc"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"cadeias-soja-zs","name":"cadeias soja zs","description":"Causal chain for soybeans: consecutive dry days in the Mato Grosso belt (leads yield and shipped volume by months) → forecast rainfall in MT and the South → soybean volume actually exported last month from the official trade registry → year-over-year change. Brazil is the largest soybean exporter; this is the physical and trade side of global supply, not a price feed. Free sample, no payment: https://api.brazilayer.com/v1/cadeias/amostra","tags":["brazil","x402","cadeias"],"examples":["GET https://api.brazilayer.com/v1/cadeias/soja_zs"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"cadeias-capital-br","name":"cadeias capital br","description":"Causal chain for Brazilian capital flight pressure: the live premium paid for USDT over the official central-bank rate (leads perceived FX stress by hours to days) → where institutional money actually moved, net flows into fixed income versus equities across the R$ 13.8tn fund industry → the official PTAX rate. Two independent signals, one reading: are locals paying up for dollars while funds turn defensive? Free sample, no payment: https://api.brazilayer.com/v1/cadeias/amostra","tags":["brazil","x402","cadeias"],"examples":["GET https://api.brazilayer.com/v1/cadeias/capital_br"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"desmatamento-municipio","name":"desmatamento municipio","description":"Deforestation profile of a Brazilian municipality by IBGE code, from the official INPE satellite alert system (DETER, Amazon and Cerrado): area cleared and alert count since 31 Dec 2020 — the EUDR cutoff date — plus 30/90/365-day windows, breakdown by class (clear-cut, degradation, mining) and rank among affected municipalities. The origin-risk layer for coffee, soy, beef, cocoa entering the EU. Free sample, no payment: https://api.brazilayer.com/v1/desmatamento/amostra","tags":["brazil","x402","desmatamento"],"examples":["GET https://api.brazilayer.com/v1/desmatamento/municipio/1507300"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"desmatamento-fornecedor","name":"desmatamento fornecedor","description":"From a Brazilian company's CNPJ to the deforestation record of its municipality: registered address, then satellite-detected clearing in that municipality since the EUDR cutoff, with a risk level. Screens suppliers of EU-regulated commodities before the December 2026 deadline. Regional risk indicator to prioritise due diligence — the registered address is not the production plot, and the response says so. Free sample, no payment: https://api.brazilayer.com/v1/desmatamento/amostra","tags":["brazil","x402","desmatamento"],"examples":["GET https://api.brazilayer.com/v1/desmatamento/fornecedor/00000000000191"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"desmatamento-ranking","name":"desmatamento ranking","description":"Where Brazilian deforestation is concentrated right now: rank municipalities or states by area cleared in a window you choose, filterable by biome (Amazon or Cerrado), from official INPE satellite alerts. Feeds ESG screening, carbon-project integrity checks and commodity-origin risk. Free sample, no payment: https://api.brazilayer.com/v1/desmatamento/amostra","tags":["brazil","x402","desmatamento"],"examples":["GET https://api.brazilayer.com/v1/desmatamento/ranking"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"cnpj-socio-busca","name":"cnpj socio busca","description":"Reverse lookup: find every Brazilian company where a given person or entity appears as partner/shareholder, by name (full-text, accent-insensitive). Returns partner name, company CNPJ and legal name, role and entry date. The highest-value query for due diligence — data straight from the official Receita Federal CNPJ registry (personal tax IDs come pre-masked from the source). Free sample, no payment: https://api.brazilayer.com/v1/cnpj/amostra","tags":["brazil","x402","cnpj"],"examples":["GET https://api.brazilayer.com/v1/cnpj/socio/busca"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"free-tools","name":"free tools","description":"Free, unlimited: validate and normalize Brazilian CNPJ and CPF, and free samples of every paid dataset (same response shape, no payment).","tags":["brazil","free","validation"],"examples":["GET https://api.brazilayer.com/v1/ferramentas","GET https://api.brazilayer.com/v1/cnpj/amostra"],"inputModes":["application/json"],"outputModes":["application/json"]}]}