Pular para o conteúdo
Balanços.AI

api pública · beta

Os balanços do Brasil, direto no seu código.

Uma API REST em JSON pra buscar empresas, ler balanços, DREs, publicações e rankings — de uma planilha, um ETL ou o produto que você está construindo. Autentica por chave, responde em segundos, sem contrato pra assinar.

Criar minha chave grátisLer o guiaBaixar collection PostmanAdicionar ao Postman(abre em nova aba)api.balancos.ai/v1
38.727
empresas na base
REST · JSON
sem SDK obrigatório
60 / min
chamadas por conta
grátis
beta aberto

uma chamada real

GET /v1/empresas?q=petrobras

Troque bal_live_SEU_TOKEN pela chave que você cria em Minha conta. A resposta vem no envelope padrão do contrato — veja o formato completo no guia.

curl "https://api.balancos.ai/v1/empresas?q=petrobras" \
  -H "Authorization: Bearer bal_live_SEU_TOKEN"

os recursos

Seis rotas de empresas, o dataset unificado

Cada rota tem o exemplo de resposta completo no guia, com cada campo explicado.

GET v1/empresas?q=

Busca por razão social, nome fantasia ou CNPJ (inteiro ou raiz). Até 20 resultados com slug e link.

GET v1/empresas/{chave}

Ficha cadastral: CNAE, natureza jurídica, situação, capital, UF/município, setor.

GET v1/empresas/{chave}/balancos

Balanços patrimoniais em reais, um item por exercício, com fonte (LLM ou XBRL) e escala declarada.

GET v1/empresas/{chave}/dres

Demonstrações de resultado (DRE) por exercício, mesmo formato dos balanços.

GET v1/empresas/{chave}/documentos

Índice de publicações legais, mais recentes primeiro. Até 100 por chamada.

GET v1/ranking

Maiores ou que mais crescem, por ativo, receita, lucro ou crescimento — com filtros de UF e setor.

as fontes, conta a conta

Dez rotas da CVM, nove do Banco Central

O acervo de cada fonte oficial como ela publica, sem passar pela unificação: chave própria (CNPJ ou código CVM; CodInst, CNPJ ou raiz), valores em reais, catálogo com cursor e ranking por período.

CVM — companhias abertas

A DFP de cada companhia aberta desde 2010: entregas e reapresentações, BP e DRE macro, as oito demonstrações conta a conta, parecer do auditor e capital social.

  • GET v1/cvm/companhias — catálogo com cursor
  • GET v1/cvm/companhias/{chave} — ficha, /dfps, /balancos, /dres
  • GET v1/cvm/dfps/{id_doc}/demonstracoes — conta a conta (bpa, bpp, dre, dra, dfc, dmpl, dva)
  • GET v1/cvm/dfps/{id_doc}/parecer — relatório do auditor, texto integral
  • GET v1/cvm/ranking — maiores por ativo, PL, receita ou lucro
Ver as rotas no guia →

BCB — IF.data

Toda instituição supervisionada pelo Banco Central, trimestre a trimestre desde 2000, nos três níveis de consolidação: série macro, DRE derivada, os 22 relatórios do portal conta a conta, conglomerados e ranking.

  • GET v1/bcb/instituicoes — catálogo com filtros e cursor
  • GET v1/bcb/instituicoes/{chave} — ficha, /trimestres, /resultados
  • GET v1/bcb/instituicoes/{chave}/relatorios — relatórios do portal conta a conta
  • GET v1/bcb/conglomerados/{codinst} — conglomerado e membros
  • GET v1/bcb/ranking — maiores por data-base e nível
Ver as rotas no guia →

plano gratuito

Um plano só, pensado pra validar seu uso

Grátis, sem cartão

Um plano único: 60 chamadas por minuto por conta e até 5 chaves ativas. Sem cota mensal.

Toda chamada admitida conta

Mesmo terminando em 404 ou erro. Chave inválida, o piso por IP e /docs não contam.

Contrato estável

Campos não somem nem trocam de tipo dentro do v1 — mudança incompatível é sempre /v2.

Fontes oficiais

Diários oficiais, jornais e portais de RI, mais o acervo da CVM e o IF.data do BCB, com link do original.

Cobrança e planos pagos ainda não existem — quando existirem, o plano gratuito continua. Detalhes de contagem e os headers de limite estão no guia, seção Limites.

Crie sua chave e faça a primeira chamada

Grátis, sem cartão de crédito. Prefere um assistente de IA em vez de código? Veja o servidor MCP.

Ir para Minha conta