Access comprehensive Brazilian data covering economic, legal, environmental, and public administration domains. Perform due diligence, market analysis, and compliance checks using official government sources and financial indicators. Streamline research for judicial processes, public spending, and demographic trends across the country.
Agente IA → GET /v1/bcb/selic → 402 Payment Required
→ Paga $0.003 USDC on-chain (Base)
→ Retry com header X-PAYMENT
→ 200 OK + dados
O protocolo x402 permite que agentes de IA paguem por dados automaticamente, sem cadastro ou chave de API. Basta ter USDC na rede Base.
Início rápido
curl (explorar sem pagar)
# Health checkcurl https://databr.api.br/health
# Ver requisitos de pagamento de qualquer endpointcurl-I https://databr.api.br/v1/bcb/selic
# → 402 Payment Required + JSON com instruções x402
Python SDK
pip install databr
from databr import DataBR
client = DataBR(private_key="0x...")# wallet com USDC na Base# Taxa Selicselic = client.bcb.selic()print(selic.data)# {"valor": "14.25", ...}# Empresa por CNPJempresa = client.empresas.consultar("33000167000101")print(empresa.data["razao_social"])# Due diligence completadd = client.empresas.due_diligence("33000167000101")# Formato LLM-readyipca = client.economia.ipca(format="context")print(ipca.context)# texto pronto para prompt
MCP (Claude, Cursor, etc.)
Listado no MCP Marketplace — instale direto pelo marketplace ou adicione manualmente ao seu MCP client:
from databr import DataBR, NotFoundError, PaymentError, RateLimitError
try: empresa = client.empresas.consultar("00000000000000")except NotFoundError:print("CNPJ não encontrado")except PaymentError:print("Pagamento falhou — verificar saldo USDC")except RateLimitError as e:print(f"Rate limit — retry em {e.retry_after}s")
Testnet
client = DataBR(private_key="0x...", network="testnet")# Base Sepolia, USDC de teste
Fontes de dados
42 coletores automáticos + 8 on-demand, cobrindo:
Fonte
Órgão
Atualização
Selic, PTAX, crédito, reservas, PIX, Focus
BCB
Diária/semanal
IPCA, PIB, população, pesquisas
IBGE
Diária/mensal
Cotações, Ibovespa
B3
Diária (dias úteis)
Fundos, fatos relevantes, cotas
CVM
Diária
Candidatos, bens, doações, filiados
TSE
Anual / On-demand
Licitações PNCP
Portal da Transparência
Diária
Acórdãos, certidões, inabilitados
TCU
Semanal
Deputados, senadores, proposições
Câmara/Senado
Diária
RREO, RGF, Tesouro Direto
Tesouro Nacional
Diária/mensal
Exportações, importações
ComexStat
Mensal
Tarifas, geração, carga
ANEEL/ONS
Semanal/diária
Medicamentos
ANVISA
Mensal
Operadoras, planos
ANS
Semanal
DETER, PRODES, MapBiomas
INPE
Diária/mensal
Embargos
IBAMA
Semanal
Aeronaves, transportadores, acidentes
ANAC/ANTT/PRF
Semanal/mensal
Censo escolar
INEP
Semestral
RAIS, CAGED
MTE (FTP)
Mensal/anual
Decisões STF, STJ
Tribunais superiores
Diária
Combustíveis
ANP
Semanal
Séries macro
IPEA
Diária
Diários oficiais
Querido Diário
On-demand
CNPJ
minhareceita.org
On-demand
Compliance CEIS/CNEP
CGU
On-demand
Processos judiciais
DataJud CNJ
On-demand
Carga tributária NCM/NBS
IBPT
On-demand
Acordos leniência, PEP, renúncias, PGFN
CGU/Portal da Transparência
On-demand
Operações de crédito
BNDES (CKAN)
On-demand
Alíquotas ICMS (27 UFs)
CONFAZ/SEFAZ
Estático (2026)
Desenvolvimento local
Pré-requisitos
Go 1.24+
Docker (PostgreSQL + Redis)
Setup
git clone https://github.com/igorpdev/databr.git
cd databr
# Subir PostgreSQL e Redisdocker-compose up -d# Configurar variáveiscp .env.example .env
# Editar .env com suas configurações# Rodar APIgo run cmd/api/main.go
# Rodar coletores (em outro terminal)go run cmd/collector/main.go
# Testesgo test ./...
A API sobe em http://localhost:8080. Sem WALLET_ADDRESS configurado, os endpoints /v1/* funcionam sem pagamento (modo dev).