Balanço Patrimonial

Finance

Consulte o balanço patrimonial de ações e outros ativos listados na B3, com dados anuais e trimestrais.

Entenda a saúde financeira de uma empresa em um único endpoint. O balanço patrimonial é como uma fotografia do patrimônio de uma companhia em uma data específica — o que ela possui (ativos), o que ela deve (passivos) e o que sobra para os acionistas (patrimônio líquido).

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

O que é o Balanço Patrimonial?

O balanço patrimonial responde a uma pergunta fundamental: qual é a situação financeira desta empresa hoje?

Ele é dividido em três grandes blocos:

Bloco	O que representa	Exemplo
Ativos	Tudo que a empresa possui — dinheiro em caixa, imóveis, máquinas, direitos a receber.	Caixa, estoques, imobilizado
Passivos	Tudo que a empresa deve — empréstimos, fornecedores, impostos.	Dívidas de curto e longo prazo
Patrimônio Líquido	O que sobra para os acionistas após subtrair os passivos dos ativos.	Capital social, reservas de lucros

Os dados são consolidados, incluíndo a empresa e suas subsidiárias como um grupo econômico único.

Períodos

Você pode consultar dados anuais ou trimestrais. Os nomes de campo period_type e fiscal_period indicam o tipo de período:

`period`	Descrição	`fiscal_period`
`annual` (padrão)	Exercícios anuais completos, em ordem decrescente.	`FY`
`quarterly`	Trimestres, em ordem decrescente.	`Q1`, `Q2`, `Q3`, `Q4`

Requisição

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

GEThttps://api.hgbrasil.com/v2/finance/balance-sheets?tickers=B3:PETR4&key=suachave

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

const url = new URL("/v2/finance/balance-sheets", "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/balance-sheets';

$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/balance-sheets'

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/balance-sheets')

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/balance-sheets?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/balance-sheets";

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": 29.4,
    "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",
          "end_date": "2025-12-31",
          "fiscal_year": 2025,
          "fiscal_period": "FY",
          "assets": {
            "total": 1223389000000,
            "current_assets": 140026000000,
            "cash_and_equivalents": 35608000000,
            "short_term_investments": 15000000000,
            "accounts_receivable": 25461000000,
            "inventory": 45173000000,
            "biological_assets": 0,
            "taxes_recoverable": 11147000000,
            "prepaid_expenses": 0,
            "other_current_assets": 7637000000,
            "non_current_assets": 1083363000000,
            "non_current_receivables": 141830000000,
            "non_current_financial_investments": 0,
            "related_party_receivables": 0,
            "non_current_trade_receivables": 14000000,
            "deferred_tax_assets": 0,
            "other_non_current_assets": 0,
            "equity_method_investments": 3024000000,
            "property_plant_and_equipment": 924624000000,
            "right_of_use_assets": 0,
            "goodwill": 0,
            "intangible_assets": 13885000000
          },
          "liabilities": {
            "current_liabilities": 198368000000,
            "employee_benefits_payable": 15236000000,
            "accounts_payable": 40948000000,
            "taxes_payable": 7110000000,
            "short_term_debt": 67253000000,
            "other_current_liabilities": 45321000000,
            "current_provisions": 21934000000,
            "non_current_liabilities": 607434000000,
            "long_term_debt": 316772000000,
            "other_non_current_liabilities": 3168000000,
            "deferred_tax_liabilities": 34965000000,
            "non_current_provisions": 252529000000
          },
          "equity": {
            "total": 417587000000,
            "share_capital": 205432000000,
            "additional_paid_in_capital": 3106000000,
            "revaluation_surplus": 0,
            "legal_and_statutory_reserves": 158278000000,
            "retained_earnings": 0,
            "accumulated_oci": 48970000000,
            "valuation_adjustments": 0,
            "translation_adjustments": 0,
            "other_accumulated_oci": 48970000000,
            "non_controlling_interest": 1801000000
          }
        },
        {
          "period_type": "annual",
          "end_date": "2024-12-31",
          "fiscal_year": 2024,
          "fiscal_period": "FY",
          "assets": {
            "total": 1124797000000,
            "current_assets": 135212000000,
            "cash_and_equivalents": 20254000000,
            "short_term_investments": 26397000000,
            "accounts_receivable": 22080000000,
            "inventory": 41550000000,
            "biological_assets": 0,
            "taxes_recoverable": 12175000000,
            "prepaid_expenses": 0,
            "other_current_assets": 12756000000,
            "non_current_assets": 989585000000,
            "non_current_receivables": 127626000000,
            "non_current_financial_investments": 0,
            "related_party_receivables": 0,
            "non_current_trade_receivables": 3605000000,
            "deferred_tax_assets": 0,
            "other_non_current_assets": 0,
            "equity_method_investments": 4081000000,
            "property_plant_and_equipment": 843917000000,
            "right_of_use_assets": 0,
            "goodwill": 0,
            "intangible_assets": 13961000000
          },
          "liabilities": {
            "current_liabilities": 194808000000,
            "employee_benefits_payable": 9336000000,
            "accounts_payable": 37659000000,
            "taxes_payable": 8671000000,
            "short_term_debt": 68783000000,
            "other_current_liabilities": 50440000000,
            "current_provisions": 15501000000,
            "non_current_liabilities": 562475000000,
            "long_term_debt": 304684000000,
            "other_non_current_liabilities": 3284000000,
            "deferred_tax_liabilities": 9100000000,
            "non_current_provisions": 245407000000
          },
          "equity": {
            "total": 367514000000,
            "share_capital": 205432000000,
            "additional_paid_in_capital": -2457000000,
            "revaluation_surplus": 0,
            "legal_and_statutory_reserves": 95193000000,
            "retained_earnings": 0,
            "accumulated_oci": 67838000000,
            "valuation_adjustments": 0,
            "translation_adjustments": 0,
            "other_accumulated_oci": 67838000000,
            "non_controlling_interest": 1508000000
          }
        }
      ],
      "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 balanço em uma data-base:

Campo	Tipo	Descrição	Exemplo
`period_type`	`string`	Tipo do período: `annual` ou `quarterly`.	annual
`end_date`	`string`	Data-base do balanço (ponto no tempo).	2024-12-31
`fiscal_year`	`number`	Ano fiscal.	2024
`fiscal_period`	`string`	Período fiscal: `FY` (anual) ou `Q1`–`Q4` (trimestral).	FY

Assets (Ativo)

O objeto assets contém os bens e direitos da empresa:

Campo	Tipo	Descrição
`total`	`number`	Ativo total.
`current_assets`	`number`	Ativo circulante — bens e direitos realizáveis em até 12 meses.
`cash_and_equivalents`	`number`	Caixa e equivalentes de caixa.
`short_term_investments`	`number`	Aplicações financeiras de curto prazo.
`accounts_receivable`	`number`	Contas a receber de clientes.
`inventory`	`number`	Estoques de matéria-prima, produtos em elaboração e acabados.
`biological_assets`	`number`	Ativos biológicos circulantes (ex.: rebanho, plantações).
`taxes_recoverable`	`number`	Tributos a recuperar.
`prepaid_expenses`	`number`	Despesas antecipadas.
`other_current_assets`	`number`	Outros ativos circulantes.
`non_current_assets`	`number`	Ativo não circulante — bens e direitos realizáveis após 12 meses.
`non_current_receivables`	`number`	Realizável a longo prazo — total do grupo.
`non_current_financial_investments`	`number`	Aplicações financeiras de longo prazo.
`related_party_receivables`	`number`	Créditos com partes relacionadas (controladas e coligadas).
`non_current_trade_receivables`	`number`	Contas a receber de longo prazo oriundas das operações.
`deferred_tax_assets`	`number`	Tributos diferidos ativos.
`other_non_current_assets`	`number`	Outros ativos não circulantes.
`equity_method_investments`	`number`	Participações avaliadas pelo método da equivalência patrimonial.
`property_plant_and_equipment`	`number`	Ativo imobilizado — máquinas, imóveis, veículos e equipamentos.
`right_of_use_assets`	`number`	Ativos de direito de uso (arrendamentos e aluguéis capitalizados).
`goodwill`	`number`	Ágio por expectativa de rentabilidade futura (goodwill).
`intangible_assets`	`number`	Ativo intangível — marcas, patentes, software e licenças.

Os campos right_of_use_assets e goodwill podem retornar null quando não identificados com segurança para a empresa consultada. Quando goodwill for null, seu valor pode estar incluído em intangible_assets.

Liabilities (Passivo)

O objeto liabilities contém as obrigações da empresa:

Campo	Tipo	Descrição
`current_liabilities`	`number`	Passivo circulante — obrigações com vencimento em até 12 meses.
`employee_benefits_payable`	`number`	Obrigações sociais e trabalhistas (salários, férias, encargos).
`accounts_payable`	`number`	Fornecedores.
`taxes_payable`	`number`	Obrigações fiscais.
`short_term_debt`	`number`	Empréstimos e financiamentos de curto prazo.
`other_current_liabilities`	`number`	Outras obrigações circulantes.
`current_provisions`	`number`	Provisões de curto prazo (contingências, garantias).
`non_current_liabilities`	`number`	Passivo não circulante — obrigações com vencimento após 12 meses.
`long_term_debt`	`number`	Empréstimos e financiamentos de longo prazo.
`other_non_current_liabilities`	`number`	Outras obrigações de longo prazo.
`deferred_tax_liabilities`	`number`	Tributos diferidos passivos.
`non_current_provisions`	`number`	Provisões de longo prazo.

Equity (Patrimônio Líquido)

O objeto equity representa o valor residual dos ativos após deduzir os passivos:

Campo	Tipo	Descrição
`total`	`number`	Patrimônio líquido consolidado.
`share_capital`	`number`	Capital social realizado.
`additional_paid_in_capital`	`number`	Reservas de capital (inclui ágio na emissão de ações e ações em tesouraria).
`revaluation_surplus`	`number`	Reservas de reavaliação.
`legal_and_statutory_reserves`	`number`	Reservas de lucros (legal, estatutária, retenção de lucros e outras).
`retained_earnings`	`number`	Lucros ou prejuízos acumulados.
`accumulated_oci`	`number`	Total dos outros resultados abrangentes acumulados (OCI).
`valuation_adjustments`	`number`	Ajustes de avaliação patrimonial (variações de fair value).
`translation_adjustments`	`number`	Ajustes acumulados de conversão cambial de subsidiárias no exterior.
`other_accumulated_oci`	`number`	Outros resultados abrangentes (ajustes atuariais e demais itens).
`non_controlling_interest`	`number`	Participação dos acionistas não controladores.

O campo accumulated_oci é a soma de valuation_adjustments, translation_adjustments e other_accumulated_oci.

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

Dados Fundamentalistas

Consulte uma visão consolidada de ações e outros ativos listados na B3, com cotação, indicadores fundamentalistas, dividendos e muito mais.

Previsão do Tempo

Dados meteorológicos atualizados e precisos.