DataBR — API de Dados Públicos Brasileiros

Name: DataBR — API de Dados Públicos Brasileiros
Author: igorpdev

平台与服务

by igorpdev

面向 AI agents 的巴西公共数据 API，覆盖 BCB、IBGE、CVM、B3 与合规场景，并支持 Base 上的 x402 支付。

GitHub

什么是 DataBR — API de Dados Públicos Brasileiros？

面向 AI agents 的巴西公共数据 API，覆盖 BCB、IBGE、CVM、B3 与合规场景，并支持 Base 上的 x402 支付。

README

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

code

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)

bash

# 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

bash

pip install databr

python

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:

json

{
  "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-relevantes`	$0.005	Fatos relevantes CVM
`GET /v1/mercado/{cnae}/competicao`	$0.030	Análise de competição
`GET /v1/tesouro/titulos`	$0.003	Tesouro Direto
`GET /v1/bndes/{cnpj}/operacoes`	$0.005	Operações de crédito BNDES

Transparência e governo

Endpoint	Preço	Descrição
`GET /v1/transparencia/licitacoes`	$0.003	Licitações PNCP
`GET /v1/transparencia/contratos`	$0.003	Contratos federais
`GET /v1/transparencia/servidores`	$0.003	Servidores públicos
`GET /v1/transparencia/pgfn`	$0.003	Dívida ativa PGFN por CNPJ
`GET /v1/transparencia/pep`	$0.003	Pessoas Expostas Politicamente (por nome)
`GET /v1/transparencia/leniencias`	$0.003	Acordos de leniência por CNPJ
`GET /v1/transparencia/renuncias`	$0.003	Renúncias fiscais por exercício
`GET /v1/tcu/acordaos`	$0.003	Acórdãos do TCU
`GET /v1/tcu/certidao/{cnpj}`	$0.003	Certidão TCU
`GET /v1/orcamento/despesas`	$0.003	Execução orçamentária
`GET /v1/dou/busca`	$0.007	Busca em diários oficiais

Legislativo

Endpoint	Preço	Descrição
`GET /v1/legislativo/deputados`	$0.003	Deputados federais
`GET /v1/legislativo/senado/senadores`	$0.003	Senadores
`GET /v1/legislativo/proposicoes`	$0.003	Projetos de lei
`GET /v1/legislativo/votacoes`	$0.003	Votações
`GET /v1/eleicoes/candidatos`	$0.003	Candidatos TSE
`GET /v1/eleicoes/filiados`	$0.003	Filiados partidários por UF
`GET /v1/eleicoes/compliance/{cpf_cnpj}`	$0.007	Compliance eleitoral

Jurídico

Endpoint	Preço	Descrição
`GET /v1/judicial/stf`	$0.010	Decisões do STF
`GET /v1/judicial/stj`	$0.010	Decisões do STJ
`GET /v1/judicial/processos/{doc}`	$0.015	Processos por CPF/CNPJ
`GET /v1/litigio/{cnpj}/risco`	$0.030	Risco litigioso

Ambiental

Endpoint	Preço	Descrição
`GET /v1/ambiental/desmatamento`	$0.005	Alertas DETER (INPE)
`GET /v1/ambiental/prodes`	$0.005	Monitoramento PRODES
`GET /v1/ambiental/embargos`	$0.005	Embargos IBAMA
`GET /v1/ambiental/uso-solo`	$0.005	Cobertura MapBiomas
`GET /v1/ambiental/risco/{municipio}`	$0.007	Risco ambiental
`GET /v1/ambiental/empresa/{cnpj}/esg`	$0.030	Análise ESG

Saúde, energia, transporte e mais

Endpoint	Preço	Descrição
`GET /v1/saude/medicamentos/{registro}`	$0.003	Medicamentos ANVISA
`GET /v1/saude/planos`	$0.003	Planos ANS
`GET /v1/energia/geracao`	$0.005	Geração de energia (ONS)
`GET /v1/energia/tarifas`	$0.003	Tarifas ANEEL
`GET /v1/energia/combustiveis`	$0.003	Preços ANP
`GET /v1/transporte/aeronaves`	$0.005	Aeronaves ANAC
`GET /v1/transporte/acidentes`	$0.005	Acidentes PRF
`GET /v1/comercio/exportacoes`	$0.005	Exportações (ComexStat)
`GET /v1/educacao/censo-escolar`	$0.005	Censo escolar INEP
`GET /v1/emprego/rais`	$0.005	RAIS (emprego formal)
`GET /v1/emprego/caged`	$0.005	CAGED (admissões/demissões)

Tributário

Endpoint	Preço	Descrição
`GET /v1/tributario/ncm/{codigo}`	$0.003	Carga tributária por NCM/NBS (IBPT)
`GET /v1/tributario/icms/{uf}`	$0.003	Alíquota ICMS interna de um estado
`GET /v1/tributario/icms`	$0.003	Tabela ICMS completa (27 UFs) ou interestadual

Análises compostas

Endpoint	Preço	Descrição
`GET /v1/rede/{cnpj}/influencia`	$0.050	Análise de rede e influência
`POST /v1/carteira/risco`	$0.150	Risco de carteira (múltiplos CNPJs)

Query parameters

Todos os endpoints aceitam:

Parâmetro	Exemplo	Descrição
`format`	`?format=context`	Texto LLM-ready em vez de JSON (+$0.002)
`fields`	`?fields=valor,data`	Projeção de campos
`since`	`?since=2026-01-01`	Filtrar a partir de data
`until`	`?until=2026-02-01`	Filtrar até data
`limit`	`?limit=10`	Limite de registros
`offset`	`?offset=20`	Offset para paginação

Formato de resposta

json

{
  "source": "bcb_sgs",
  "updated_at": "2026-02-21T10:00:00Z",
  "cached": true,
  "cache_age_seconds": 3600,
  "cost_usdc": "0.003",
  "data": {
    "valor": "14.25",
    "data": "2026-02-21"
  }
}

Preços

Faixa	Preço (USDC)	Exemplos
Consultas básicas	$0.003	BCB, IBGE, empresas, legislativo, tributário
Consultas padrão	$0.005	Ações B3, CVM, comércio exterior
Consultas avançadas	$0.007	Compliance empresa, DOU, risco ambiental
Premium	$0.010	Compliance completo, fundos, decisões STF/STJ
Análises cruzadas	$0.015–$0.030	Panorama, ESG, litígio, competição
Análises profundas	$0.050–$0.150	Rede de influência, due diligence, carteira
Formato contexto	+$0.002	Adicional sobre qualquer endpoint

Rate limits: 100 req/min por IP | 500 req/min por wallet x402.

Python SDK

bash

pip install databr

Namespaces disponíveis

Namespace	Exemplo	Métodos
`bcb`	`client.bcb.selic()`	selic, cambio, focus, credito, reservas, taxas_credito, pix
`empresas`	`client.empresas.consultar(cnpj)`	consultar, compliance, perfil_completo, due_diligence
`economia`	`client.economia.ipca()`	ipca, pib, panorama
`mercado`	`client.mercado.acoes("PETR4")`	acoes, fundos, cotas, fatos, indices, competicao
`compliance`	`client.compliance.verificar(cnpj)`	verificar, ceis, cnep, cepim
`judicial`	`client.judicial.processos(doc)`	processos, stf, stj, litigio
`legislativo`	`client.legislativo.deputados()`	deputados, senadores, proposicoes, votacoes
`ambiental`	`client.ambiental.desmatamento()`	desmatamento, prodes, embargos, uso_solo, esg
`transparencia`	`client.transparencia.licitacoes()`	licitacoes, contratos, servidores, orcamento
`saude`	`client.saude.medicamentos(reg)`	medicamentos, operadoras, estabelecimentos
`energia`	`client.energia.tarifas()`	tarifas, geracao, carga, combustiveis
`transporte`	`client.transporte.aeronaves()`	aeronaves, transportadores, acidentes
`comercio`	`client.comercio.exportacoes()`	exportacoes, importacoes
`emprego`	`client.emprego.rais()`	rais, caged
`tributario`	`client.tributario.ncm("22030000", uf="SP")`	ncm, icms

Tratamento de erros

python

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

python

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

bash

git clone https://github.com/igorpdev/databr.git
cd databr

# Subir PostgreSQL e Redis
docker-compose up -d

# Configurar variáveis
cp .env.example .env
# Editar .env com suas configurações

# Rodar API
go run cmd/api/main.go

# Rodar coletores (em outro terminal)
go run cmd/collector/main.go

# Testes
go test ./...

A API sobe em http://localhost:8080. Sem WALLET_ADDRESS configurado, os endpoints /v1/* funcionam sem pagamento (modo dev).

Estrutura

code

databr/
├── cmd/
│   ├── api/              # Entrypoint REST API + MCP
│   └── collector/        # Scheduler de coletores
├── internal/
│   ├── handlers/         # 30+ handlers HTTP (122 endpoints)
│   ├── collectors/       # 23 pacotes de coletores (50 fontes)
│   ├── repositories/     # PostgreSQL (pgx/v5)
│   ├── cache/            # Redis + cache em memória
│   ├── x402/             # Middleware de pagamento + pricing
│   ├── mcp/              # MCP Server (170+ tools)
│   ├── domain/           # Entidades e interfaces
│   ├── metrics/          # Prometheus
│   └── logging/          # Structured logging (slog)
├── sdk/python/           # Python SDK (PyPI: databr)
├── docs/
│   ├── openapi.yaml      # Especificação OpenAPI 3.0
│   └── landing.html      # Landing page
├── migrations/           # Schema PostgreSQL
├── Dockerfile            # API (multi-stage, ~23MB)
├── Dockerfile.collector  # Coletores
└── docker-compose.yml    # Dev: PostgreSQL 16 + Redis 7

Stack

Camada	Tecnologia
Backend	Go 1.24, Chi Router
Banco	PostgreSQL 16 (pgx/v5)
Cache	Redis (Upstash em produção)
Pagamentos	x402 protocol, USDC, Base network
Deploy	Railway
Métricas	Prometheus
MCP	mcp-go (Mark3Labs)
SDK	Python (PyPI)

Variáveis de ambiente

bash

# Obrigatórias
DATABASE_URL=postgres://databr:databr@localhost:5432/databr
REDIS_URL=redis://localhost:6379

# x402 (testnet)
WALLET_ADDRESS=0x...
X402_NETWORK=base-sepolia
X402_FACILITATOR_URL=https://facilitator.x402.rs

# x402 (mainnet)
# X402_NETWORK=base
# X402_FACILITATOR_URL=https://api.cdp.coinbase.com/platform/v2/x402
# CDP_KEY_ID=...
# CDP_KEY_SECRET=...

# APIs externas (opcionais)
TRANSPARENCIA_API_KEY=    # Portal da Transparência (CGU)
DATAJUD_API_KEY=          # DataJud (CNJ)
MINHARECEITA_URL=https://minhareceita.org

Licença

MIT

常见问题