Balanços.AI

DRE derivada da instituição: trimestre isolado e anual, por nível. chave = CodInst, CNPJ ou raiz; nivel = "individual", "financeiro" ou "prudencial" (padrão: o da instituição); periodo = "trimestre" ou "anual" (sem valor, os dois). Receita, custo, lucro bruto, operacional e líquido em reais. O IF.data publica acumulado no semestre: T1 = mar, T2 = jun − mar, T3 = set, T4 = dez − set; anual = jun + dez. `completo` diz se o período tem todas as parcelas. A consulta gera logs operacionais e, quando habilitado, histórico privado de uso autenticado com argumentos e IP, sujeito à retenção operacional de 90 dias. A ferramenta não oferece exclusão ou sobrescrita de dados financeiros.

Série trimestral macro da instituição desde 2000, por nível de consolidação. chave = CodInst, CNPJ ou raiz; nivel = "individual", "financeiro" ou "prudencial" (padrão: o nível padrão da instituição); desde/ate = data-base AAAAMM (mês 03, 06, 09 ou 12), opcionais. Uma linha por data-base com ativo total, carteira de crédito, TVM, captações, patrimônio líquido, lucro acumulado no semestre, patrimônio de referência, RWA, índices de Basileia, imobilização e alavancagem (frações) e a rede (agências, postos). Valores em reais. A consulta gera logs operacionais e, quando habilitado, histórico privado de uso autenticado com argumentos e IP, sujeito à retenção operacional de 90 dias. A ferramenta não oferece exclusão ou sobrescrita de dados financeiros.

Busca empresas brasileiras por nome ou CNPJ nos dados do balancos.ai. Use quando o usuário citar uma empresa pelo nome — a busca cobre a razão social e o nome fantasia, sem diferenciar acento, e aceita CNPJ inteiro ou só a raiz (8 dígitos), com ou sem pontuação. Retorna até 20 empresas com CNPJ, slug e link da página no balancos.ai. Com o slug (ou CNPJ) em mãos, aprofunde com analisar_empresa. A consulta gera logs operacionais e, quando habilitado, histórico privado de uso autenticado com argumentos e IP, sujeito à retenção operacional de 90 dias. A ferramenta não oferece exclusão ou sobrescrita de dados financeiros.

Retrato da companhia na CVM em uma chamada — comece por aqui. chave = CNPJ ou código CVM. Combina a ficha (denominações, família, capital social, último parecer), a linha do tempo das entregas de DFP (exercícios e versões, com id_doc e links), TODOS os balanços e DREs anuais na última versão de cada exercício, consolidado e individual, em reais, e `trimestral.mais_recente`: o ponto mais novo da série trimestral (BP, trimestre, acumulado e últimos doze meses) — cite-o quando a DFP já tiver meses. Série inteira: cvm_trimestres_companhia; conta a conta de uma entrega: cvm_demonstracoes(id_doc); parecer: cvm_parecer(id_doc); ITRs: cvm_entregas_companhia(chave, tipo="itr"). Inclua os links ao apresentar. A consulta gera logs operacionais e, quando habilitado, histórico privado de uso autenticado com argumentos e IP, sujeito à retenção operacional de 90 dias. A ferramenta não oferece exclusão ou sobrescrita de dados financeiros.

Balanços patrimoniais (BP) das DFPs, em reais, última versão por exercício. chave = CNPJ ou código CVM; ano opcional; visao = "consolidado" ou "individual" (sem valor, as duas). Um item por exercício e visão com ativo total, circulante e não circulante, passivo, patrimônio líquido, a família e a escala publicada (só proveniência: os valores já estão em reais). Para o conta a conta do BP use cvm_demonstracoes(id_doc, demonstracao="bpa" ou "bpp"). BP trimestral: cvm_trimestres_companhia. A consulta gera logs operacionais e, quando habilitado, histórico privado de uso autenticado com argumentos e IP, sujeito à retenção operacional de 90 dias. A ferramenta não oferece exclusão ou sobrescrita de dados financeiros.

Busca companhias abertas com DFP (demonstrações anuais) na CVM. termo = trecho da denominação ou prefixo de CNPJ (com ou sem pontuação). Retorna até 20 companhias por chamada, em ordem alfabética, com CNPJ, código CVM, denominação e, quando a empresa está no balancos.ai, o link da página. Havendo mais, a resposta traz proximo_cursor: refine o termo ou chame de novo com o mesmo termo e cursor=proximo_cursor (texto opaco, devolva como veio). Use o CNPJ ou o código CVM como `chave` nas outras tools cvm_*. Para o retrato completo em uma chamada, siga com cvm_analisar_companhia. A consulta gera logs operacionais e, quando habilitado, histórico privado de uso autenticado com argumentos e IP, sujeito à retenção operacional de 90 dias. A ferramenta não oferece exclusão ou sobrescrita de dados financeiros.

Conta a conta das demonstrações de uma entrega (DFP ou ITR), em reais. id_doc = número da entrega (cvm_entregas_companhia). demonstracao = "bpa", "bpp", "dre", "dra", "dfc", "dmpl" ou "dva"; sem valor, todas as da visão (resposta grande — prefira pedir uma). visao = "consolidado" ou "individual"; padrão consolidado, ou individual quando a entrega não tem consolidado. Cada conta traz código, descrição, nível, se é conta padronizada, o valor atual e o anterior (comparativo publicado na mesma entrega), sempre em reais. No ITR, a DRE e a DRA trazem dois períodos: valor_atual/valor_anterior = resultado acumulado no exercício, e valor_trimestre_atual/valor_trimestre_anterior = o trimestre isolado; no BP do ITR o anterior é o fechamento do exercício anterior. A consulta gera logs operacionais e, quando habilitado, histórico privado de uso autenticado com argumentos e IP, sujeito à retenção operacional de 90 dias. A ferramenta não oferece exclusão ou sobrescrita de dados financeiros.

Demonstrações de resultado (DRE) das DFPs, em reais, última versão por exercício. chave = CNPJ ou código CVM; ano opcional; visao = "consolidado" ou "individual" (sem valor, as duas). Receita líquida, custo, lucro bruto, operacional e líquido por exercício e visão. Conta a conta da DRE: cvm_demonstracoes(id_doc, demonstracao="dre"). Resultado trimestral ou dos últimos doze meses: cvm_resultados_companhia. A consulta gera logs operacionais e, quando habilitado, histórico privado de uso autenticado com argumentos e IP, sujeito à retenção operacional de 90 dias. A ferramenta não oferece exclusão ou sobrescrita de dados financeiros.

Uma entrega (DFP ou ITR): versões, demonstrações disponíveis, parecer e capital. id_doc = número da entrega na CVM (vem de cvm_entregas_companhia). Serve pros dois tipos — o campo `tipo` da resposta diz se é "dfp" ou "itr". Retorna a companhia, a data de referência, se é reapresentação, a escala e a moeda publicadas, as visões (consolidado, individual) e quais demonstrações cada visão tem (bpa, bpp, dre, dra, dfc, dmpl, dva), o tipo do parecer do auditor, o capital social e as outras versões da mesma data. Use antes de cvm_demonstracoes para saber o que pedir. A consulta gera logs operacionais e, quando habilitado, histórico privado de uso autenticado com argumentos e IP, sujeito à retenção operacional de 90 dias. A ferramenta não oferece exclusão ou sobrescrita de dados financeiros.

Entregas da companhia na CVM — DFP (anual) ou ITR (trimestral) — por versão. chave = CNPJ ou código CVM; tipo = "dfp" (padrão, demonstrações anuais) ou "itr" (informações trimestrais); ano opcional (ano da data de referência, de 2009 em diante). Datas de referência decrescentes; dentro de cada uma, as versões crescentes (v1, v2...), cada uma com o id_doc da CVM, a data de recebimento, o tipo do parecer e os links (documento no balancos.ai e arquivo na CVM). O id_doc é a chave de cvm_entrega, cvm_demonstracoes e cvm_parecer — a última versão de uma data é a que vale. Para números trimestrais prontos (sem abrir entrega), use cvm_trimestres_companhia. A consulta gera logs operacionais e, quando habilitado, histórico privado de uso autenticado com argumentos e IP, sujeito à retenção operacional de 90 dias. A ferramenta não oferece exclusão ou sobrescrita de dados financeiros.

Ficha da companhia aberta na CVM: cadastro derivado das entregas de DFP. chave = CNPJ (14 dígitos) ou código CVM. Retorna denominação atual e anteriores, família (comercial, financeira, seguradora), primeiro e último exercício com DFP, número de entregas e de reapresentações, o tipo do último parecer do auditor e o capital social (ações integralizadas e em tesouraria). Sem o conta a conta — para isso use cvm_entregas_companhia (pega o id_doc) e cvm_demonstracoes. A consulta gera logs operacionais e, quando habilitado, histórico privado de uso autenticado com argumentos e IP, sujeito à retenção operacional de 90 dias. A ferramenta não oferece exclusão ou sobrescrita de dados financeiros.

Relatório do auditor e declarações dos diretores de uma entrega (DFP ou ITR). id_doc = número da entrega (cvm_entregas_companhia). Na DFP é o relatório do auditor independente (sem ressalva, com ressalva, adverso, negativa de opinião); no ITR o auditor revisa, não opina — vem o Relatório da Revisão Especial, com o mesmo campo de tipo. Texto integral, mais as declarações dos diretores. Texto pode ser longo; cite o tipo e resuma. A consulta gera logs operacionais e, quando habilitado, histórico privado de uso autenticado com argumentos e IP, sujeito à retenção operacional de 90 dias. A ferramenta não oferece exclusão ou sobrescrita de dados financeiros.

Maiores companhias abertas por métrica: no exercício (DFP) ou nos últimos 12 meses. periodo = "anual" (padrão): metrica = "ativo" (ativo total), "patrimonio" (patrimônio líquido), "receita" (receita líquida) ou "lucro" (lucro líquido), e ano = exercício (obrigatório). periodo = "12m": metrica = "receita" ou "lucro" dos doze meses encerrados em data_referencia ("AAAA-MM-DD"; sem valor, a mais recente com cobertura da maioria das companhias) — é o ranking mais atual, e `ano` é ignorado. visao = "consolidado" (padrão) ou "individual"; familia = "comercial", "financeira", "seguradora" ou "desconhecida" (opcional — bancos e seguradoras têm plano de contas próprio, compare dentro da família); limite até 100 por chamada (padrão 20). Valores em reais da última versão de cada entrega. No 12m fica fora a companhia com escala suspeita na fonte ou receita negativa. Paginação: cada item traz a posicao e a resposta traz total (tamanho do ranking com os filtros) e, havendo mais, proximo_inicio — chame de novo com inicio=proximo_inicio. inicio é a posição do primeiro item (a partir de 1): inicio=101 devolve do 101º em diante. A consulta gera logs operacionais e, quando habilitado, histórico privado de uso autenticado com argumentos e IP, sujeito à retenção operacional de 90 dias. A ferramenta não oferece exclusão ou sobrescrita de dados financeiros.

Resultados (DRE) da série da companhia num só período, pra comparar no tempo. chave = CNPJ ou código CVM; periodo = "trimestre" (três meses isolados), "acumulado" (do início do exercício até a data), "12m" (últimos doze meses) ou "anual" (a DFP); sem valor, todos. desde/ate = data de referência "AAAA-MM-DD" (sem eles, as 12 datas mais recentes); visao como em cvm_trimestres_companhia. Receita líquida, custo, lucro bruto, operacional e líquido por data de referência, em reais. Use "trimestre" pra sazonalidade e comparação com o mesmo trimestre do ano anterior, e "12m" pra tendência sem sazonalidade. Mesmas marcas de cvm_trimestres_companhia (derivado, consistente, ranqueavel). A consulta gera logs operacionais e, quando habilitado, histórico privado de uso autenticado com argumentos e IP, sujeito à retenção operacional de 90 dias. A ferramenta não oferece exclusão ou sobrescrita de dados financeiros.

Série trimestral da companhia: BP, trimestre, acumulado e últimos doze meses. chave = CNPJ ou código CVM; desde/ate = data de referência "AAAA-MM-DD" (opcionais: sem eles vêm as 12 datas mais recentes, ~3 anos; a história vai até 2011); visao = "consolidado" ou "individual" (padrão: consolidado, ou individual quando a companhia não consolida). Um ponto por data de referência, do mais recente pro mais antigo, em reais, na última versão de cada entrega: o balanço daquela data e os resultados `trimestre` (três meses), `acumulado` (do início do exercício até a data) e `doze_meses`. É o dado MAIS RECENTE de uma companhia aberta — a DFP pode ter mais de um ano. Leia as marcas: derivado=true = o último trimestre do exercício não é publicado, é a DFP menos o acumulado de nove meses; consistente=false = na fonte, os trimestres isolados daquele exercício não fecham com o acumulado (avise ao citar); doze_meses é calculado por acumulados, não somando trimestres. A data de referência segue o exercício social: nem toda companhia fecha em dezembro. A consulta gera logs operacionais e, quando habilitado, histórico privado de uso autenticado com argumentos e IP, sujeito à retenção operacional de 90 dias. A ferramenta não oferece exclusão ou sobrescrita de dados financeiros.

Publicações legais de uma empresa (índice, mais recentes primeiro). chave = slug ou CNPJ. Retorna até 100 documentos com tipo, data de publicação, ano de referência e link da página do documento no balancos.ai (onde o PDF pode ser lido). Para ler o CONTEÚDO de um documento aqui na conversa, use texto_documento com o id retornado. A consulta gera logs operacionais e, quando habilitado, histórico privado de uso autenticado com argumentos e IP, sujeito à retenção operacional de 90 dias. A ferramenta não oferece exclusão ou sobrescrita de dados financeiros.

Demonstrações de resultado (DRE) de uma empresa, por exercício. chave = slug ou CNPJ. Sem ano, retorna todos os exercícios disponíveis (mais recente primeiro); com ano, só aquele. Traz receita bruta/líquida, custo, lucro bruto/operacional/líquido — sempre em reais — com o link do documento de origem no balancos.ai. A consulta gera logs operacionais e, quando habilitado, histórico privado de uso autenticado com argumentos e IP, sujeito à retenção operacional de 90 dias. A ferramenta não oferece exclusão ou sobrescrita de dados financeiros.

Ficha cadastral e panorama de dados de uma empresa. chave aceita o slug (retornado por buscar_empresas) ou o CNPJ (14 dígitos, com ou sem pontuação). Retorna cadastro (razão social, CNAE, natureza jurídica, situação, capital social, UF/município), setor, quantidade de publicações e os ANOS com balanço e com DRE disponíveis — use esses anos para chamar balancos_empresa/dres_empresa. Para o retrato completo em uma chamada, prefira analisar_empresa. A consulta gera logs operacionais e, quando habilitado, histórico privado de uso autenticado com argumentos e IP, sujeito à retenção operacional de 90 dias. A ferramenta não oferece exclusão ou sobrescrita de dados financeiros.

Ranking de empresas por métrica financeira, com filtros opcionais. metrica: "ativo" (maiores por ativo total), "receita", "lucro" (lucro líquido) ou "crescimento" (variação % do ATIVO TOTAL ano-a-ano — não é crescimento de receita). uf = sigla (SP, RS...); setor = trecho do nome do setor (ex: "energia", "saúde"); limite até 100 por chamada (padrão 20). Cada linha traz a posicao no ranking, o exercício de referência e o link da empresa no balancos.ai — exercícios podem variar entre empresas. Paginação: a resposta traz total (tamanho do ranking com os filtros) e, quando há mais, proximo_inicio — chame de novo com inicio=proximo_inicio. inicio é a posição do primeiro item (a partir de 1): inicio=101 devolve do 101º em diante. A consulta gera logs operacionais e, quando habilitado, histórico privado de uso autenticado com argumentos e IP, sujeito à retenção operacional de 90 dias. A ferramenta não oferece exclusão ou sobrescrita de dados financeiros.

Texto integral de uma publicação, para ler aqui na conversa — em pedaços ou por busca. documento_id é o id retornado por documentos_empresa ou analisar_empresa. Sem termo, devolve o texto do caractere `inicio` em diante, até `tamanho` caracteres (padrão 100 mil, teto 200 mil), com tamanho_total_chars e, se ainda houver texto, proximo_inicio: chame de novo com inicio=proximo_inicio até truncado=false para ler o documento inteiro (uma DF completa tem de 300 a 800 mil caracteres: parecer do auditor e notas explicativas ficam no fim). Com termo (ex: "parecer", "opinião", "empréstimos", "contingências", "eventos subsequentes"), devolve só os trechos que contêm o termo, com contexto e a posição (inicio) de cada um, sem distinção de caixa nem acento — use para ir direto ao ponto e depois continuar a leitura a partir dali com inicio. Zero ocorrências de "ressalva" ou "ênfase" não significa que não há parecer: um parecer sem ressalva não usa essas palavras — localize o parecer por "opinião" ou "auditor" e leia o trecho. Nem todo documento tem texto extraído; nesse caso a resposta indica e o documento pode ser lido no link da página. A consulta gera logs operacionais e, quando habilitado, histórico privado de uso autenticado com argumentos e IP, sujeito à retenção operacional de 90 dias. A ferramenta não oferece exclusão ou sobrescrita de dados financeiros.