x402 Protocol · USDC on Base

Dados públicos brasileiros
prontos para agentes de IA

API unificada com 120+ endpoints cobrindo economia, empresas, mercado, legislativo, transparência e mais. Pagamento instantâneo via protocolo x402 — sem cadastro, sem API key, sem limites artificiais.

Explorar API → Quick Start
120+
Endpoints
30+
Fontes oficiais
$0.003
A partir de
<200ms
Latência média

Como funciona

Protocolo x402 — pagamento nativo em HTTP, sem intermediários.

1

Request

Agente faz GET /v1/bcb/selic

2

402 Payment Required

API retorna preço e endereço de pagamento em USDC (Base network)

3

Pagamento on-chain

SDK paga automaticamente e envia header X-PAYMENT

4

200 OK + Dados

Dados retornados em JSON — prontos para consumo

Endpoints

Dados de 30+ fontes governamentais e de mercado, organizados por domínio.

Banco Central

$0.003
  • /v1/bcb/selic
  • /v1/bcb/cambio/{moeda}
  • /v1/bcb/pix/estatisticas
  • /v1/bcb/credito
  • /v1/bcb/reservas
  • /v1/bcb/taxas-credito
  • /v1/bcb/indicadores/{serie}
  • /v1/bcb/capitais
+ sml, ifdata, base-monetaria

Empresas

$0.003
  • /v1/empresas/{cnpj}
  • /v1/empresas/{cnpj}/socios
  • /v1/empresas/{cnpj}/simples
  • /v1/endereco/{cep}
+ compliance ($0.007), perfil-completo ($0.020), due diligence ($0.075)

Economia

$0.003
  • /v1/economia/ipca
  • /v1/economia/pib
  • /v1/economia/focus
  • /v1/economia/panorama

IBGE

$0.003
  • /v1/ibge/municipio/{ibge}
  • /v1/ibge/municipios/{uf}
  • /v1/ibge/estados
  • /v1/ibge/populacao
  • /v1/ibge/pnad
  • /v1/ibge/cnae/{codigo}
+ regioes, inpc, pim, ipca15, pmc, pms

Mercado Financeiro

$0.005
  • /v1/mercado/acoes/{ticker}
  • /v1/mercado/fundos/{cnpj}
  • /v1/mercado/fundos/{cnpj}/cotas
  • /v1/mercado/fatos-relevantes
  • /v1/mercado/indices/ibovespa
+ análise de fundos ($0.010)

Legislativo

$0.003
  • /v1/legislativo/deputados
  • /v1/legislativo/deputados/{id}/despesas
  • /v1/legislativo/proposicoes
  • /v1/legislativo/votacoes
  • /v1/legislativo/senado/senadores
+ partidos, eventos, comissoes, frentes, blocos, materias

Transparência

$0.003
  • /v1/transparencia/contratos
  • /v1/transparencia/licitacoes
  • /v1/transparencia/servidores
  • /v1/transparencia/emendas
  • /v1/transparencia/obras
+ beneficios, cartoes, viagens, transferencias, pensionistas

Compliance

$0.003
  • /v1/compliance/ceis/{cnpj}
  • /v1/compliance/cnep/{cnpj}
  • /v1/compliance/cepim/{cnpj}
  • /v1/compliance/{cnpj}
Full compliance ($0.010) · Score ($0.010)

Tesouro Nacional

$0.003
  • /v1/tesouro/rreo
  • /v1/tesouro/rgf
  • /v1/tesouro/entes
  • /v1/tesouro/dca
  • /v1/tesouro/titulos

Eleições

$0.003
  • /v1/eleicoes/candidatos
  • /v1/eleicoes/bens
  • /v1/eleicoes/doacoes
  • /v1/eleicoes/resultados
+ compliance eleitoral ($0.007)

Ambiental

$0.005
  • /v1/ambiental/desmatamento
  • /v1/ambiental/prodes
  • /v1/ambiental/uso-solo
  • /v1/ambiental/embargos
  • /v1/ambiental/risco/{municipio}
+ ESG empresarial ($0.030)

Judicial (DataJud)

$0.010
  • /v1/judicial/processos/{doc}
  • /v1/judicial/processo/{numero}
91 tribunais CNJ · Busca por CPF/CNPJ ou número unificado

Saúde Pública (DATASUS)

$0.003
  • /v1/saude/estabelecimentos
  • /v1/saude/mortalidade
  • /v1/saude/nascimentos
  • /v1/saude/hospitais
  • /v1/saude/dengue
  • /v1/saude/vacinacao/{ano}
SIM, SINASC, CNES, SINAN, PNI

Diários Oficiais

$0.003
  • /v1/diarios/busca
  • /v1/diarios/municipios
  • /v1/diarios/temas
  • /v1/diarios/tema/{tema}
Querido Diário · Diários oficiais municipais

Tributário

$0.003
  • /v1/tributario/ncm/{codigo}
  • /v1/tributario/icms/{uf}
  • /v1/tributario/icms
IBPT carga tributária · ICMS 27 UFs · Interestadual + DIFAL

Mais domínios

$0.003+
  • /v1/ipea/serie/{codigo}
  • /v1/energia/combustiveis
  • /v1/saude/medicamentos/{registro}
  • /v1/transporte/aeronaves/{prefixo}
  • /v1/tcu/acordaos
  • /v1/pncp/orgaos
IPEA, Energia, Transporte, TCU, PNCP, Orçamento

Quick Start

Integre em minutos — o SDK DataBR cuida do pagamento x402 automaticamente.

cURL
Python
TypeScript
# 1. Primeira chamada retorna 402 com dados de pagamento
curl -s https://databr.api.br/v1/bcb/selic
# {"x402Version":1,"accepts":[{"scheme":"exact","network":"eip155:8453",
#   "maxAmountRequired":"3000","asset":"0x833589...","payTo":"0x..."}]}

# 2. Instale o SDK:
#    pip install databr          (Python — SDK oficial com namespaces tipados)
#    npm install x402             (TypeScript — SDK genérico x402)
#    go get github.com/coinbase/x402/go  (Go — SDK genérico x402)

# 3. Com o SDK Python, a chamada é transparente:
#    from databr import DataBR
#    client = DataBR(private_key="0x...")
#    selic = client.bcb.selic()  → Paga automaticamente → Retorna dados
# pip install databr
from databr import DataBR

# Configure com sua wallet (USDC na rede Base)
client = DataBR(private_key="0x...")

# Namespaces tipados — autocompletion no IDE
selic = client.bcb.selic()
print(selic.data["valor"])      # "14.25"
print(selic.cost_usdc)           # "0.003"

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

# Compliance + Judicial + Ambiental — tudo com a mesma API
compliance = client.compliance.verificar("33000167000101")
processos  = client.judicial.processos("33000167000101")
dengue     = client.saude.dengue(municipio="3550308")
import { createx402Client } from "x402";

// Configure com sua wallet (USDC na rede Base)
const client = createx402Client({
  privateKey: process.env.WALLET_PRIVATE_KEY,
  network: "base-mainnet",
});

// Pagamento automático via x402
const resp = await client.get(
  "https://databr.api.br/v1/empresas/33000167000101"
);

console.log(resp.data.razao_social); // "PETROLEO BRASILEIRO S.A."
console.log(resp.cost_usdc);         // "0.003"

Python SDK

pip install databr — namespaces tipados, pagamento automático, zero configuração.

15 namespaces

BCB, empresas, economia, mercado, compliance, judicial, legislativo, ambiental, transparência, saúde, energia, transporte, educação, emprego, comércio

Pagamento automático

x402 transparente — basta ter USDC na rede Base. Sem callbacks, sem webhooks.

Tipagem completa

py.typed + DataBRResponse com .data, .source, .cost_usdc, .context

Error handling

NotFoundError, PaymentError, RateLimitError — exceções específicas por tipo de falha

Preços

Pague apenas pelo que usar. Sem assinatura, sem limites, sem cadastro.

$0.003
Basic
BCB, IBGE, empresas, legislativo, tesouro
$0.005
Standard
Ações B3, CVM, ambiental, comércio exterior
$0.007
Enhanced
Compliance cruzado, DOU, risco ambiental
$0.010
Premium
Compliance completo, fundos CVM, score
$0.015
Advanced
Processos judiciais, panorama econômico
$0.020
Composite
Perfil completo, regulação setorial
$0.030
Deep Analysis
Competição, ESG, risco de litígio
$0.075
Due Diligence
Análise completa de empresa

Formato ?format=context (LLM-ready) adiciona +$0.002 ao preço base.

Para agentes de IA

Construído para consumo programático por LLMs e agentes autônomos.

Sem cadastro

Nada de API keys, OAuth, ou formulários. Pague e use.

Sem rate limit artificial

Limite apenas pelo throughput real. Cada request pago é processado.

format=context

Respostas em texto estruturado otimizado para contexto de LLM.

MCP Server

Disponível via Model Context Protocol em /mcp.