brazilayer
Brazilian public data for AI agents — paid per call, no signup, no API keys.
Query the full Brazilian company registry (69M companies), screen against every official sanction list, and pull government contracts — from official sources (Receita Federal, CGU, MTE, PNCP), as clean JSON. Your agent pays per request ($0.005–$0.02) in USDC on Base via the x402 protocol.
Ideal for KYB, AML and counterparty due diligence on Brazilian entities — including crypto exchanges, OTC desks and fintechs onboarding Brazilian companies.
pip install brazilayer
Quick start
from brazilayer import Brazilayer
bl = Brazilayer() # no wallet: free samples only
bl.amostra_cnpj() # learn the response format, free
bl = Brazilayer(private_key="0x...") # wallet with a few USD of USDC on Base
bl.empresa("00.000.000/0001-91") # registration card $0.005
bl.integridade("00000000000191") # sanctions screening $0.01
bl.contratos_fornecedor("00000000000191") # public contracts won $0.01
bl.buscar_empresas(nome="padaria", uf="RJ") # company search $0.01
Payment is automatic: on HTTP 402 the client signs a USDC authorization
(EIP-3009, gasless for you) and retries. One call ≈ 2 seconds end to end.
⚠️ Use a dedicated wallet with a small budget — a few dollars covers hundreds of calls. Never your main wallet.
LangChain
from brazilayer.langchain import get_tools # pip install 'brazilayer[langchain]'
tools = get_tools(private_key="0x...") # 29 StructuredTools, agent-ready
CrewAI
from brazilayer.crewai import get_tools # pip install 'brazilayer[crewai]'
tools = get_tools(private_key="0x...")
MCP (Claude Desktop / Claude Code / Cursor)
Prefer MCP? Use our MCP server: github.com/brazilayer/mcp
(one-click .mcpb install available).
What's inside
| Method | Data | Price |
|---|---|---|
empresa(cnpj) |
Registration card from Receita Federal | $0.005 |
socios(cnpj) |
Partners/shareholders | $0.005 |
empresa_completa(cnpj) |
Full profile + branches | $0.01 |
buscar_empresas(**f) |
Full-text company search | $0.01 |
buscar_por_socio(nome) |
Reverse partner lookup | $0.02 |
integridade(cnpj) |
5 official sanction lists, one call | $0.01 |
contratos_fornecedor(cnpj) |
Public contracts won + totals | $0.01 |
instituicao_bcb(cnpj) |
Central Bank authorization + verified domains | $0.005 |
licitacoes_abertas(**f) |
Open tenders, live | $0.01 |
enriquecer(cnpj) |
Full KYB profile in one call — registration + partners + sanctions + BCB + contracts | $0.05 |
noticias(**f) |
BR financial & crypto news + AI sentiment, 15-min refresh | $0.002 |
indicadores() |
Selic, IPCA, PTAX + Focus survey medians | $0.002 |
cambio() |
Official PTAX + live BRL crypto premium (capital-flow signal) | $0.002 |
commodities_clima() |
Crop-weather stress per belt: rain, drought, frost risk | $0.005 |
commodities_fogo() |
Satellite fire hotspots + drought proxy (INPE) | $0.002 |
commodities_exportacoes() |
Monthly commodity exports with YoY | $0.005 |
commodities_hidrologia() |
Stored hydro energy by subsystem (ONS) | $0.002 |
commodities_briefing() |
Daily AI Brazil Commodity Briefing (English) | $0.10 |
fundos_fluxos() |
Daily net flows of institutional money by fund class (R$13.8tn) | $0.005 |
fundos_verificar(cnpj) |
Verify a fund at the CVM (anti-fraud) | $0.005 |
fundos_ranking(**f) |
Rank/screen ~25,000 fund classes | $0.01 |
tributos_ncm(codigo) |
IBS/CBS regime for a product, with legal basis | $0.005 |
tributos_busca(termo) |
Search the tax-reform annexes by description | $0.005 |
tributos_calendario() |
Tax transition calendar 2026-2033 | $0.002 |
cadeia(nome) |
Causal chain with lead time — energy, coffee, soy, capital flows | $0.05 |
desmatamento_municipio(ibge) |
Cleared area since the EUDR cutoff (INPE satellite) | $0.01 |
desmatamento_fornecedor(cnpj) |
Supplier CNPJ → deforestation of its municipality | $0.02 |
desmatamento_ranking(**f) |
Where clearing is concentrated | $0.01 |
amostra_*() / health() |
Samples & status | free |
Docs: api.brazilayer.com/docs · OpenAPI: /openapi.yaml · Terms: /termos · Contact: contato@brazilayer.com
Also listed on the x402 Bazaar and the
MCP Registry (io.github.brazilayer/mcp).
1 maintainer
Metadata
1 maintainer
Release files for brazilayer 0.8.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| brazilayer-0.8.0.tar.gz | 9.5 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| brazilayer-0.8.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 22.0 kB
Release files / brazilayer-0.8.0.tar.gz
| Download URL | brazilayer-0.8.0.tar.gz |
|---|---|
| Size | 9.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
efe27507ffe2a0dd9d20bb6224b9e7695c4a90d18719a2914bd992239dd95b77
|
|
BLAKE2b-256 checksum How to use checksums |
2fce6cb8fdb088498a2460aa808017380302e048619c6b4b16219162c91d7f65
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.16 {"installer":{"name":"uv","version":"0.11.16","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / brazilayer-0.8.0-py3-none-any.whl
| Download URL | brazilayer-0.8.0-py3-none-any.whl |
|---|---|
| Size | 12.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c763cfa51ce4a0b0e1c76c72ad6ea46554d0c6ff3ff6845f118d40c7a6ba9c8e
|
|
BLAKE2b-256 checksum How to use checksums |
920c6f5d85ddac93450cd085469d083247ffd3761287ed4dae932b1d0610387c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.16 {"installer":{"name":"uv","version":"0.11.16","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
