Agente IA → GET /v1/bcb/selic → 402 Payment Required
         → Paga $0.003 USDC on-chain (Base)
         → Retry com header X-PAYMENT
         → 200 OK + dados

# 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

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

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

{
  "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"
  }
}

pip install databr

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")

client = DataBR(private_key="0x...", network="testnet")  # Base Sepolia, USDC de teste

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 ./...

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

# 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