Fluxo de Caixa

HG BrasilFinance
Consulte a demonstração do fluxo de caixa de ações e outros ativos listados na B3, com dados anuais e trimestrais.

Acompanhe para onde o dinheiro vai — e de onde ele vem. O fluxo de caixa revela como uma empresa gera e utiliza seus recursos financeiros, separando as movimentações em três atividades: operacional, investimento e financiamento.

Para acessar os dados da API é necessário utilizar uma chave de integração e um plano compatível.

O que é o Fluxo de Caixa?

Enquanto a demonstração de resultados mostra o lucro contábil, o fluxo de caixa mostra o dinheiro que efetivamente entrou e saiu do caixa. Uma empresa pode ter lucro no papel, mas estar queimando caixa — e vice-versa.

O demonstrativo é dividido em três seções:

SeçãoO que representaExemplo
OperacionalCaixa gerado (ou consumido) pelas atividades do dia a dia da empresa.Recebimento de clientes, pagamento de fornecedores
InvestimentoCaixa usado para comprar ou vender ativos de longo prazo.Compra de máquinas, aquisição de empresas
FinanciamentoCaixa obtido ou devolvido a credores e acionistas.Empréstimos, pagamento de dividendos

A soma das três seções (mais o efeito cambial, quando aplicável) resulta na variação líquida do caixa no período.

Os dados utilizam o método indireto — partem do lucro líquido e ajustam por itens não monetários (como depreciação) e variações no capital de giro. Valores de saída de caixa são negativos por convenção.

Períodos e TTM

Você pode consultar dados anuais ou trimestrais. No modo anual, a API calcula automaticamente o TTM (Trailing Twelve Months) — uma visão acumulada dos últimos 12 meses, combinando os trimestres mais recentes. Isso permite acompanhar a geração de caixa atualizada sem esperar o relatório anual.

periodOrdem dos statements
annual (padrão)TTM (se disponível), seguido dos exercícios anuais em ordem decrescente.
quarterlyTrimestres em ordem decrescente, sem TTM.
O TTM só é incluído quando existe um trimestre mais recente que o último relatório anual. O campo fiscal_period será TTM para identificá-lo.

Requisição

Informe o ticker no formato {fonte}:{símbolo}.

GET
https://api.hgbrasil.com/v2/finance/cash-flows?tickers=B3:PETR4&key=suachave
curl -X GET "https://api.hgbrasil.com/v2/finance/cash-flows?tickers=B3%3APETR4&key=suachave"

Parâmetros

tickers
string required
Ticker do ativo no formato {fonte}:{símbolo}. Para múltiplos ativos, separe por vírgula: B3:PETR4,B3:VALE3.
period
string
Tipo de período fiscal: annual (padrão) ou quarterly.
start_date
string
Data inicial para filtrar os dados (yyyy-mm-dd).
end_date
string
Data final para filtrar os dados (yyyy-mm-dd).
days_ago
number
Número de dias atrás a partir de hoje. Use 0 para dados do dia atual.

Resposta

Campos

Os dados de cada ativo retornam no array results:

Ativo

CampoTipoDescriçãoExemplo
tickerstringTicker completo no formato {fonte}:{símbolo}.B3:PETR4
unitstringUnidade dos valores (currency para moeda).currency
currencystringMoeda dos valores.BRL
symbolstringCódigo de negociação do ativo.PETR4
namestringNome simplificado da empresa.Petrobras
full_namestringRazão social completa da empresa.Petróleo Brasileiro S.A.

Período

Cada item do array statements representa o fluxo de caixa de um período:

CampoTipoDescriçãoExemplo
period_typestringTipo do período: annual ou quarterly.annual
start_datestringData de início do período.2024-01-01
end_datestringData de encerramento do período.2024-12-31
fiscal_yearnumberAno fiscal.2024
fiscal_periodstringPeríodo fiscal: FY, TTM, ou Q1Q4.FY

Operating (Atividades Operacionais)

O objeto operating mostra o caixa gerado pelas atividades principais da empresa:

CampoTipoDescrição
totalnumberCaixa líquido das atividades operacionais.
cash_from_operationsnumberCaixa gerado nas operações (antes de variações de capital de giro). Inclui lucro líquido e ajustes não monetários.
depreciation_and_amortizationnumberDepreciação, amortização e exaustão — despesas não monetárias adicionadas de volta ao caixa.
stock_based_compensationnumberRemuneração baseada em ações (planos de stock options).
changes_in_working_capitalnumberVariações nos ativos e passivos operacionais (capital de giro).
other_operatingnumberOutros fluxos operacionais (impostos pagos, juros pagos e demais itens).
Os campos depreciation_and_amortization e stock_based_compensation podem retornar null quando não identificados com segurança para a empresa consultada.

Investing (Atividades de Investimento)

O objeto investing mostra o caixa usado em aquisições e vendas de ativos de longo prazo:

CampoTipoDescrição
totalnumberCaixa líquido das atividades de investimento.
capital_expendituresnumberInvestimentos em ativos imobilizados e intangíveis (CapEx).
O campo capital_expenditures pode retornar null quando não identificado com segurança. O campo total sempre estará disponível e representa o fluxo completo de investimentos (incluindo aquisições, vendas de ativos e outros).

Financing (Atividades de Financiamento)

O objeto financing mostra o caixa obtido ou devolvido a credores e acionistas:

CampoTipoDescrição
totalnumberCaixa líquido das atividades de financiamento.
dividends_paidnumberDividendos e juros sobre capital próprio pagos (valor negativo).
share_repurchasesnumberRecompra de ações em tesouraria (valor negativo).
Os campos dividends_paid e share_repurchases podem retornar null quando não identificados com segurança. O campo total sempre estará disponível e representa o fluxo completo de financiamentos (incluindo empréstimos, amortizações e outros).

Reconciliação

Campos na raiz do statement que conciliam a variação do caixa no período:

CampoTipoDescrição
exchange_rate_effectnumberVariação cambial sobre caixa e equivalentes.
net_change_in_cashnumberAumento ou redução líquida de caixa no período.
beginning_cash_balancenumberSaldo de caixa no início do período.
ending_cash_balancenumberSaldo de caixa no final do período.
A reconciliação permite verificar a consistência: operating.total + investing.total + financing.total + exchange_rate_effect = net_change_in_cash, e beginning_cash_balance + net_change_in_cash = ending_cash_balance.

Fonte

O objeto source contém informações sobre a origem dos dados:

CampoTipoDescriçãoExemplo
source.symbolstringCódigo da fonte.CVM
source.namestringNome da fonte.Comissão de Valores Mobiliários
source.full_namestringNome completo da fonte.Comissão de Valores Mobiliários
source.urlstringSite oficial.https://www.cvm.gov.br/
source.location.timezonestringFuso horário.America/Sao_Paulo