Fatos contábeis de uma empresa
fatos_contabeisReceita, EBIT, lucro, patrimônio, dívida e caixa de uma AÇÃO em R$, por ano ou trimestre, com a conta CVM de cada número.
Use quando: "qual foi a receita líquida e o lucro da WEG em 2025?"; "lucro do 2T da Petrobras"; "caixa da Magalu no último balanço".
NÃO use para: ROE, margem, dívida/EBITDA já calculados → indicadores_anuais; versões republicadas → reapresentacoes; informe de FII → fii.
Fonte e fórmula: DFP (anual) ou ITR (trimestral=True, 1T a 3T isolados) da CVM, versão vigente; origem = conta CVM exata. O balanço numa data passada (as_of) e versões antigas só na REST, com chave.
Retorna: fatos: uma linha por período com as contas padronizadas em R$ e origem; citacao.
Vazio ou erro: o 4º trimestre não vem no trimestral (é a DFP anual). Erro de código traz sugestoes; FII aponta para fii.
Acesso: ABERTA: qualquer ticker, sem chave, um por vez (sem chave: 2000 consultas por hora e 20000 por dia, por endereço; com chave_api vale o limite da chave). Traz citacao: cite-a ao usar o número.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"ticker": "<ticker>"
},
"name": "fatos_contabeis"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ticker | Yes | Código de AÇÃO na B3, ex.: PETR4, VALE3, ITUB4. Aceita petr4, PETR4.SA, BVMF:PETR4, PETR4F (fracionário) e código antigo (vira o atual). Código de FII, ETF ou BDR devolve erro com `tente_assim`. | |
| chave_api | No | Chave de API opcional. Vazia = acesso aberto: a descrição da ferramenta diz se devolve amostra ou exige chave (chave grátis, sem cartão). | |
| trimestral | No | False (padrão) = DFP anual; True = ITR trimestral (1T a 3T isolados). |