Fluxo de Caixa
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.
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ção | O que representa | Exemplo |
|---|---|---|
| Operacional | Caixa gerado (ou consumido) pelas atividades do dia a dia da empresa. | Recebimento de clientes, pagamento de fornecedores |
| Investimento | Caixa usado para comprar ou vender ativos de longo prazo. | Compra de máquinas, aquisição de empresas |
| Financiamento | Caixa 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.
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.
period | Ordem dos statements |
|---|---|
annual (padrão) | TTM (se disponível), seguido dos exercícios anuais em ordem decrescente. |
quarterly | Trimestres em ordem decrescente, sem TTM. |
fiscal_period será TTM para identificá-lo.Requisição
Informe o ticker no formato {fonte}:{símbolo}.
GEThttps://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"
const url = new URL("/v2/finance/cash-flows", "https://api.hgbrasil.com")
url.searchParams.set("tickers", "B3:PETR4")
url.searchParams.set("key", "suachave")
const response = await fetch(url.href)
const data = await response.json()
$url = 'https://api.hgbrasil.com/v2/finance/cash-flows';
$queryString = http_build_query([
'tickers' => 'B3:PETR4',
'key' => 'suachave'
]);
$response = file_get_contents($url . '?' . $queryString);
$data = json_decode($response, true);
import requests
url = 'https://api.hgbrasil.com/v2/finance/cash-flows'
params = {
'tickers': 'B3:PETR4',
'key': 'suachave'
}
response = requests.get(url, params=params)
data = response.json()
require 'net/http'
require 'uri'
require 'json'
uri = URI('https://api.hgbrasil.com/v2/finance/cash-flows')
uri.query = URI.encode_www_form({
tickers: 'B3:PETR4',
key: 'suachave'
})
response = Net::HTTP.get(uri)
data = JSON.parse(response, symbolize_names: true)
import java.net.URI;
import java.net.http.*;
var url = "https://api.hgbrasil.com/v2/finance/cash-flows?tickers=B3%3APETR4&key=suachave";
var client = HttpClient.newHttpClient();
var request = HttpRequest.newBuilder()
.uri(URI.create(url))
.GET()
.build();
var response = client.send(request, HttpResponse.BodyHandlers.ofString());
var data = response.body();
using System.Net.Http;
using System.Text.Json;
using System.Web;
var client = new HttpClient();
var baseUrl = "https://api.hgbrasil.com/v2/finance/cash-flows";
var queryParams = HttpUtility.ParseQueryString(string.Empty);
queryParams["tickers"] = "B3:PETR4";
queryParams["key"] = "suachave";
var url = $"{baseUrl}?{queryParams}";
var response = await client.GetStringAsync(url);
var data = JsonSerializer.Deserialize<dynamic>(response);
Ativos Disponíveis
Consulte os ativos disponíveis para uso na API. Use o campo abaixo para buscar por nome ou símbolo.
Parâmetros
{fonte}:{símbolo}. Para múltiplos ativos, separe por vírgula: B3:PETR4,B3:VALE3.annual (padrão) ou quarterly.yyyy-mm-dd).yyyy-mm-dd).0 para dados do dia atual.Resposta
Campos
Os dados de cada ativo retornam no array results:
Ativo
| Campo | Tipo | Descrição | Exemplo |
|---|---|---|---|
ticker | string | Ticker completo no formato {fonte}:{símbolo}. | B3:PETR4 |
unit | string | Unidade dos valores (currency para moeda). | currency |
currency | string | Moeda dos valores. | BRL |
symbol | string | Código de negociação do ativo. | PETR4 |
name | string | Nome simplificado da empresa. | Petrobras |
full_name | string | Razã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:
| Campo | Tipo | Descrição | Exemplo |
|---|---|---|---|
period_type | string | Tipo do período: annual ou quarterly. | annual |
start_date | string | Data de início do período. | 2024-01-01 |
end_date | string | Data de encerramento do período. | 2024-12-31 |
fiscal_year | number | Ano fiscal. | 2024 |
fiscal_period | string | Período fiscal: FY, TTM, ou Q1–Q4. | FY |
Operating (Atividades Operacionais)
O objeto operating mostra o caixa gerado pelas atividades principais da empresa:
| Campo | Tipo | Descrição |
|---|---|---|
total | number | Caixa líquido das atividades operacionais. |
cash_from_operations | number | Caixa gerado nas operações (antes de variações de capital de giro). Inclui lucro líquido e ajustes não monetários. |
depreciation_and_amortization | number | Depreciação, amortização e exaustão — despesas não monetárias adicionadas de volta ao caixa. |
stock_based_compensation | number | Remuneração baseada em ações (planos de stock options). |
changes_in_working_capital | number | Variações nos ativos e passivos operacionais (capital de giro). |
other_operating | number | Outros fluxos operacionais (impostos pagos, juros pagos e demais itens). |
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:
| Campo | Tipo | Descrição |
|---|---|---|
total | number | Caixa líquido das atividades de investimento. |
capital_expenditures | number | Investimentos em ativos imobilizados e intangíveis (CapEx). |
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:
| Campo | Tipo | Descrição |
|---|---|---|
total | number | Caixa líquido das atividades de financiamento. |
dividends_paid | number | Dividendos e juros sobre capital próprio pagos (valor negativo). |
share_repurchases | number | Recompra de ações em tesouraria (valor negativo). |
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:
| Campo | Tipo | Descrição |
|---|---|---|
exchange_rate_effect | number | Variação cambial sobre caixa e equivalentes. |
net_change_in_cash | number | Aumento ou redução líquida de caixa no período. |
beginning_cash_balance | number | Saldo de caixa no início do período. |
ending_cash_balance | number | Saldo de caixa no final do período. |
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:
| Campo | Tipo | Descrição | Exemplo |
|---|---|---|---|
source.symbol | string | Código da fonte. | CVM |
source.name | string | Nome da fonte. | Comissão de Valores Mobiliários |
source.full_name | string | Nome completo da fonte. | Comissão de Valores Mobiliários |
source.url | string | Site oficial. | https://www.cvm.gov.br/ |
source.location.timezone | string | Fuso horário. | America/Sao_Paulo |