Balanço Patrimonial

HG BrasilFinance
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:

BlocoO que representaExemplo
AtivosTudo que a empresa possui — dinheiro em caixa, imóveis, máquinas, direitos a receber.Caixa, estoques, imobilizado
PassivosTudo que a empresa deve — empréstimos, fornecedores, impostos.Dívidas de curto e longo prazo
Patrimônio LíquidoO 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:

periodDescriçãofiscal_period
annual (padrão)Exercícios anuais completos, em ordem decrescente.FY
quarterlyTrimestres, em ordem decrescente.Q1, Q2, Q3, Q4

Requisição

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

GET
https://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"

Ativos Disponíveis

Consulte os ativos disponíveis para uso na API. Use o campo abaixo para buscar por nome ou símbolo.

Nenhum ativo encontrado para "".

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": 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

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 balanço em uma data-base:

CampoTipoDescriçãoExemplo
period_typestringTipo do período: annual ou quarterly.annual
end_datestringData-base do balanço (ponto no tempo).2024-12-31
fiscal_yearnumberAno fiscal.2024
fiscal_periodstringPeríodo fiscal: FY (anual) ou Q1Q4 (trimestral).FY

Assets (Ativo)

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

CampoTipoDescrição
totalnumberAtivo total.
current_assetsnumberAtivo circulante — bens e direitos realizáveis em até 12 meses.
cash_and_equivalentsnumberCaixa e equivalentes de caixa.
short_term_investmentsnumberAplicações financeiras de curto prazo.
accounts_receivablenumberContas a receber de clientes.
inventorynumberEstoques de matéria-prima, produtos em elaboração e acabados.
biological_assetsnumberAtivos biológicos circulantes (ex.: rebanho, plantações).
taxes_recoverablenumberTributos a recuperar.
prepaid_expensesnumberDespesas antecipadas.
other_current_assetsnumberOutros ativos circulantes.
non_current_assetsnumberAtivo não circulante — bens e direitos realizáveis após 12 meses.
non_current_receivablesnumberRealizável a longo prazo — total do grupo.
non_current_financial_investmentsnumberAplicações financeiras de longo prazo.
related_party_receivablesnumberCréditos com partes relacionadas (controladas e coligadas).
non_current_trade_receivablesnumberContas a receber de longo prazo oriundas das operações.
deferred_tax_assetsnumberTributos diferidos ativos.
other_non_current_assetsnumberOutros ativos não circulantes.
equity_method_investmentsnumberParticipações avaliadas pelo método da equivalência patrimonial.
property_plant_and_equipmentnumberAtivo imobilizado — máquinas, imóveis, veículos e equipamentos.
right_of_use_assetsnumberAtivos de direito de uso (arrendamentos e aluguéis capitalizados).
goodwillnumberÁgio por expectativa de rentabilidade futura (goodwill).
intangible_assetsnumberAtivo 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:

CampoTipoDescrição
current_liabilitiesnumberPassivo circulante — obrigações com vencimento em até 12 meses.
employee_benefits_payablenumberObrigações sociais e trabalhistas (salários, férias, encargos).
accounts_payablenumberFornecedores.
taxes_payablenumberObrigações fiscais.
short_term_debtnumberEmpréstimos e financiamentos de curto prazo.
other_current_liabilitiesnumberOutras obrigações circulantes.
current_provisionsnumberProvisões de curto prazo (contingências, garantias).
non_current_liabilitiesnumberPassivo não circulante — obrigações com vencimento após 12 meses.
long_term_debtnumberEmpréstimos e financiamentos de longo prazo.
other_non_current_liabilitiesnumberOutras obrigações de longo prazo.
deferred_tax_liabilitiesnumberTributos diferidos passivos.
non_current_provisionsnumberProvisões de longo prazo.

Equity (Patrimônio Líquido)

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

CampoTipoDescrição
totalnumberPatrimônio líquido consolidado.
share_capitalnumberCapital social realizado.
additional_paid_in_capitalnumberReservas de capital (inclui ágio na emissão de ações e ações em tesouraria).
revaluation_surplusnumberReservas de reavaliação.
legal_and_statutory_reservesnumberReservas de lucros (legal, estatutária, retenção de lucros e outras).
retained_earningsnumberLucros ou prejuízos acumulados.
accumulated_ocinumberTotal dos outros resultados abrangentes acumulados (OCI).
valuation_adjustmentsnumberAjustes de avaliação patrimonial (variações de fair value).
translation_adjustmentsnumberAjustes acumulados de conversão cambial de subsidiárias no exterior.
other_accumulated_ocinumberOutros resultados abrangentes (ajustes atuariais e demais itens).
non_controlling_interestnumberParticipaçã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:

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