DataBR

API de dados públicos brasileiros para agentes de IA, com pagamento on-chain via protocolo x402 (USDC na rede Base).

Sem cadastro. Sem API key. Pague por consulta.

Documentação | Python SDK | MCP Server | MCP Marketplace | Smithery

---

Como funciona

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 check
curl https://databr.api.br/health

# Ver requisitos de pagamento de qualquer endpoint
curl -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 Selic
selic = client.bcb.selic()
print(selic.data)  # {"valor": "14.25", ...}

# Empresa por CNPJ
empresa = client.empresas.consultar("33000167000101")
print(empresa.data["razao_social"])

# Due diligence completa
dd = client.empresas.due_diligence("33000167000101")

# Formato LLM-ready
ipca = 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:

{
  "mcpServers": {
    "databr": {
      "url": "https://databr.api.br/mcp"
    }
  }
}

170+ ferramentas disponíveis cobrindo todos os endpoints da API.

---

Endpoints

122 endpoints organizados por domínio. Documentação completa em databr.api.br/docs.

Economia

Endpoint	Preço	Descrição
GET /v1/bcb/selic	$0.003	Taxa Selic vigente
GET /v1/bcb/cambio/{moeda}	$0.003	Câmbio PTAX (USD, EUR, etc.)
GET /v1/bcb/credito	$0.003	Oferta de crédito
GET /v1/bcb/reservas	$0.003	Reservas internacionais
GET /v1/bcb/taxas-credito	$0.003	Taxas de juros por modalidade
GET /v1/bcb/pix/estatisticas	$0.003	Estatísticas PIX
GET /v1/bcb/focus	$0.003	Expectativas Focus (mercado)
GET /v1/economia/ipca	$0.003	Inflação IPCA
GET /v1/economia/pib	$0.003	PIB trimestral
GET /v1/economia/panorama	$0.015	Panorama econômico consolidado
GET /v1/ipea/serie/{codigo}	$0.003	Séries IPEA (macro, social, regional)

Empresas

Endpoint	Preço	Descrição
GET /v1/empresas/{cnpj}	$0.003	Dados cadastrais (Receita Federal)
GET /v1/empresas/{cnpj}/compliance	$0.007	Check rápido CEIS/CNEP/CEPIM
GET /v1/empresas/{cnpj}/setor	$0.007	Análise setorial
GET /v1/empresas/{cnpj}/perfil-completo	$0.020	Perfil completo com cruzamentos
GET /v1/empresas/{cnpj}/duediligence	$0.075	Due diligence automatizada
GET /v1/compliance/{cnpj}	$0.010	Compliance completo (CGU + CNJ)
GET /v1/credito/score/{cnpj}	$0.010	Score de crédito estimado

Mercado financeiro

Endpoint	Preço	Descrição
GET /v1/mercado/acoes/{ticker}	$0.005	Cotação de ações (B3)
GET /v1/mercado/indices/ibovespa	$0.005	Índice Ibovespa
GET /v1/mercado/fundos/{cnpj}	$0.010	Detalhes de fundo (CVM)
GET /v1/mercado/fundos/{cnpj}/cotas	$0.005	Cotas de fundo
GET /v1/mercado/fundos/{cnpj}/analise	$0.010	Análise de fundo
`GET /v1/mercado/fatos-rel

... View full README on GitHub