Fluxo de Caixa

Finance

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çã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.

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.

`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.

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

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

{
  "metadata": {
    "key_status": "valid",
    "cached": false,
    "response_time_ms": 43.2,
    "language": "pt-br"
  },
  "results": [
    {
      "ticker": "B3:PETR4",
      "unit": "currency",
      "currency": "BRL",
      "symbol": "PETR4",
      "name": "Petrobrás",
      "full_name": "Petroleo Brasileiro S.A. Petrobras",
      "statements": [
        {
          "period_type": "annual",
          "start_date": "2025-01-01",
          "end_date": "2025-12-31",
          "fiscal_year": 2025,
          "fiscal_period": "FY",
          "operating": {
            "total": 200333000000,
            "cash_from_operations": 253975000000,
            "depreciation_and_amortization": 84388000000,
            "stock_based_compensation": null,
            "changes_in_working_capital": -25534000000,
            "other_operating": -28108000000
          },
          "investing": {
            "total": -86114000000,
            "capital_expenditures": -108714000000
          },
          "financing": {
            "total": -97122000000,
            "dividends_paid": -45438000000,
            "share_repurchases": 0
          },
          "exchange_rate_effect": -1743000000,
          "net_change_in_cash": 15354000000,
          "beginning_cash_balance": 20254000000,
          "ending_cash_balance": 35608000000
        },
        {
          "period_type": "annual",
          "start_date": "2024-01-01",
          "end_date": "2024-12-31",
          "fiscal_year": 2024,
          "fiscal_period": "FY",
          "operating": {
            "total": 204037000000,
            "cash_from_operations": 260492000000,
            "depreciation_and_amortization": 67033000000,
            "stock_based_compensation": null,
            "changes_in_working_capital": -20055000000,
            "other_operating": -36400000000
          },
          "investing": {
            "total": -72363000000,
            "capital_expenditures": -79856000000
          },
          "financing": {
            "total": -179974000000,
            "dividends_paid": -100692000000,
            "share_repurchases": -1919000000
          },
          "exchange_rate_effect": 6941000000,
          "net_change_in_cash": -41359000000,
          "beginning_cash_balance": 61613000000,
          "ending_cash_balance": 20254000000
        }
      ],
      "source": {
        "symbol": "CVM",
        "name": "CVM",
        "full_name": "Comissão de Valores Mobiliários",
        "url": "https://www.gov.br/cvm/pt-br",
        "location": {
          "timezone": "America/Sao_Paulo"
        }
      }
    }
  ]
}

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).

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:

Campo	Tipo	Descrição
`total`	`number`	Caixa líquido das atividades de investimento.
`capital_expenditures`	`number`	Investimentos 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:

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).

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:

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.

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:

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

Demonstração de Resultados (DREs)

Consulte a demonstração do resultado do exercício (DREs) de ações e outros ativos listados na B3, com dados anuais e trimestrais.

Indicadores Econômicos

Acesse IPCA, IGP-M, SELIC, CDI e outros indicadores econômicos brasileiros com séries históricas completas.