Balanço Patrimonial
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).
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 |
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
{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
{
"metadata": {
"key_status": "valid",
"cached": false,
"response_time_ms": 1.2,
"language": "pt-br"
},
"results": [],
"errors": [
{
"code": "INVALID_TICKER",
"message": "Ticker inválido.",
"help": "https://hgbrasil.com/docs",
"details": {
"symbol": "B3:PETR4"
}
}
]
}
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. |
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. |
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 |