Dados Fundamentalistas

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

Tenha em um único endpoint uma visão completa de um ativo: cotação em tempo real, múltiplos de valuation, indicadores de endividamento, margens, rentabilidade e dividendos. É o ponto de partida ideal para análises fundamentalistas e triagem de ações.

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

O que são Dados Fundamentalistas?

A análise fundamentalista busca responder a uma pergunta central: quanto vale esta empresa e o preço atual faz sentido?

Para responder, é preciso combinar informações de diversas fontes: cotação, balanço, resultados, fluxo de caixa e proventos, e transformá-las em indicadores comparáveis. Esse endpoint faz esse trabalho pesado por você, entregando um conjunto padronizado de métricas agrupadas por tema:

GrupoO que mede
ValuationSe o ativo está barato ou caro em relação aos seus resultados e patrimônio.
EndividamentoO nível de alavancagem e a capacidade de honrar obrigações.
MargensA eficiência em transformar receita em lucro.
RentabilidadeO retorno gerado sobre ativos, patrimônio e capital investido.
DividendosO retorno em proventos distribuídos nos últimos 12 meses.
Os indicadores são calculados a partir dos dados consolidados de balanço patrimonial, demonstração de resultados, fluxo de caixa, dividendos e da cotação mais recente.

Períodos e TTM

Você pode consultar indicadores calculados com base em períodos anuais ou trimestrais. No modo anual, a API calcula automaticamente o TTM (Trailing Twelve Months) — uma visão acumulada dos últimos 12 meses — para refletir a situação mais atualizada da empresa sem esperar o fechamento do exercício anual.

periodOrdem dos statements
annual (padrão)TTM (se disponível), seguido dos exercícios anuais em ordem decrescente.
quarterlyTrimestres em ordem decrescente, sem TTM.

Requisição

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

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

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.
fields
string
Filtro de campos de retorno para obter apenas o que precisa. Separe os caminhos por vírgula: market.value,valuation.price_to_earnings_ratio.
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": 414.9,
    "language": "pt-br"
  },
  "results": [
    {
      "ticker": "B3:PETR4",
      "kind": "stock",
      "unit": "currency",
      "currency": "BRL",
      "symbol": "PETR4",
      "name": "Petrobrás",
      "full_name": "Petroleo Brasileiro S.A. Petrobras",
      "tax_id": "33.000.167/0001-01",
      "shares_outstanding": 12888732761,
      "quote": {
        "value": 38.24,
        "change_value": 0.28,
        "change_percent": 0.7376,
        "market_cap": 523629000000,
        "updated_at": "2026-07-05T20:47:21-03:00"
      },
      "statements": [
        {
          "period_type": "ttm",
          "start_date": "2025-04-01",
          "end_date": "2026-03-31",
          "fiscal_year": 2026,
          "fiscal_period": "TTM",
          "valuation": {
            "enterprise_value": 872046000000,
            "ebitda": 230884000000,
            "earnings_per_share": 8.347,
            "book_value_per_share": 32.399,
            "price_to_earnings_ratio": 4.58,
            "price_to_book_ratio": 1.18,
            "price_to_sales_ratio": 1.05,
            "price_to_ebitda": 2.27,
            "price_to_ebit": 3.64,
            "price_to_asset_ratio": 0.43,
            "price_to_current_assets_ratio": 3.74,
            "price_to_free_cash_flow_ratio": 6.1,
            "ev_to_ebitda": 3.78,
            "ev_to_ebit": 6.06
          },
          "leverage": {
            "current_ratio": 0.71,
            "equity_to_asset_ratio": 0.34,
            "debt_to_equity_ratio": 0.83,
            "net_debt_to_ebitda_ratio": 1.51,
            "net_debt_to_ebit_ratio": 2.42
          },
          "margins": {
            "gross_profit_margin": 47.36,
            "ebitda_margin": 46.35,
            "ebit_margin": 28.88,
            "net_profit_margin": 21.6
          },
          "profitability": {
            "asset_turnover_ratio": 0.42,
            "return_on_assets": 8.79,
            "return_on_equity": 25.76,
            "return_on_invested_capital": 10.38,
            "return_on_capital_employed": 14.03
          },
          "dividends": {
            "yield_percent": 5.2,
            "yield_currency": 1.987
          }
        },
        {
          "period_type": "annual",
          "start_date": "2025-01-01",
          "end_date": "2025-12-31",
          "fiscal_year": 2025,
          "fiscal_period": "FY",
          "valuation": {
            "enterprise_value": 872046000000,
            "ebitda": 230016000000,
            "earnings_per_share": 8.582,
            "book_value_per_share": 32.399,
            "price_to_earnings_ratio": 4.46,
            "peg_ratio": 0.02,
            "price_to_book_ratio": 1.18,
            "price_to_sales_ratio": 1.05,
            "price_to_ebitda": 2.28,
            "price_to_ebit": 3.6,
            "price_to_asset_ratio": 0.43,
            "price_to_current_assets_ratio": 3.74,
            "price_to_free_cash_flow_ratio": 5.72,
            "ev_to_ebitda": 3.79,
            "ev_to_ebit": 5.99
          },
          "leverage": {
            "current_ratio": 0.71,
            "equity_to_asset_ratio": 0.34,
            "debt_to_equity_ratio": 0.83,
            "net_debt_to_ebitda_ratio": 1.51,
            "net_debt_to_ebit_ratio": 2.39
          },
          "margins": {
            "gross_profit_margin": 47.63,
            "ebitda_margin": 46.23,
            "ebit_margin": 29.27,
            "net_profit_margin": 22.23
          },
          "profitability": {
            "asset_turnover_ratio": 0.42,
            "return_on_assets": 9.04,
            "return_on_equity": 26.49,
            "return_on_invested_capital": 10.43,
            "return_on_capital_employed": 14.21
          },
          "dividends": {
            "yield_percent": 5.2,
            "yield_currency": 1.987
          }
        },
        {
          "period_type": "annual",
          "start_date": "2024-01-01",
          "end_date": "2024-12-31",
          "fiscal_year": 2024,
          "fiscal_period": "FY",
          "valuation": {
            "enterprise_value": 876842000000,
            "ebitda": 204234000000,
            "earnings_per_share": 2.871,
            "book_value_per_share": 28.514,
            "price_to_earnings_ratio": 13.32,
            "peg_ratio": -0.19,
            "price_to_book_ratio": 1.34,
            "price_to_sales_ratio": 1.07,
            "price_to_ebitda": 2.56,
            "price_to_ebit": 3.82,
            "price_to_asset_ratio": 0.47,
            "price_to_current_assets_ratio": 3.87,
            "price_to_free_cash_flow_ratio": 4.22,
            "ev_to_ebitda": 4.29,
            "ev_to_ebit": 6.39
          },
          "leverage": {
            "current_ratio": 0.69,
            "equity_to_asset_ratio": 0.33,
            "debt_to_equity_ratio": 0.96,
            "net_debt_to_ebitda_ratio": 1.73,
            "net_debt_to_ebit_ratio": 2.57
          },
          "margins": {
            "gross_profit_margin": 50.21,
            "ebitda_margin": 41.61,
            "ebit_margin": 27.95,
            "net_profit_margin": 7.54
          },
          "profitability": {
            "asset_turnover_ratio": 0.45,
            "return_on_assets": 3.29,
            "return_on_equity": 10.07,
            "return_on_invested_capital": 9.98,
            "return_on_capital_employed": 14.75
          },
          "dividends": {
            "yield_percent": 0,
            "yield_currency": 0
          }
        },
        {
          "period_type": "annual",
          "start_date": "2023-01-01",
          "end_date": "2023-12-31",
          "fiscal_year": 2023,
          "fiscal_period": "FY",
          "valuation": {
            "enterprise_value": 765078000000,
            "ebitda": 255546000000,
            "earnings_per_share": 9.711,
            "book_value_per_share": 29.665,
            "price_to_earnings_ratio": 3.94,
            "peg_ratio": -0.12,
            "price_to_book_ratio": 1.29,
            "price_to_sales_ratio": 1.02,
            "price_to_ebitda": 2.05,
            "price_to_ebit": 2.77,
            "price_to_asset_ratio": 0.5,
            "price_to_current_assets_ratio": 3.33,
            "price_to_free_cash_flow_ratio": 3.37,
            "ev_to_ebitda": 2.99,
            "ev_to_ebit": 4.04
          },
          "leverage": {
            "current_ratio": 0.96,
            "equity_to_asset_ratio": 0.36,
            "debt_to_equity_ratio": 0.63,
            "net_debt_to_ebitda_ratio": 0.94,
            "net_debt_to_ebit_ratio": 1.28
          },
          "margins": {
            "gross_profit_margin": 52.72,
            "ebitda_margin": 49.91,
            "ebit_margin": 36.98,
            "net_profit_margin": 24.45
          },
          "profitability": {
            "asset_turnover_ratio": 0.51,
            "return_on_assets": 11.91,
            "return_on_equity": 32.74,
            "return_on_invested_capital": 15.05,
            "return_on_capital_employed": 21.35
          },
          "dividends": {
            "yield_percent": 3.77,
            "yield_currency": 1.441
          }
        },
        {
          "period_type": "annual",
          "start_date": "2022-01-01",
          "end_date": "2022-12-31",
          "fiscal_year": 2022,
          "fiscal_period": "FY",
          "valuation": {
            "enterprise_value": 762609000000,
            "ebitda": 362457000000,
            "earnings_per_share": 14.664,
            "book_value_per_share": 28.272,
            "price_to_earnings_ratio": 2.61,
            "peg_ratio": 0.03,
            "price_to_book_ratio": 1.35,
            "price_to_sales_ratio": 0.82,
            "price_to_ebitda": 1.44,
            "price_to_ebit": 1.78,
            "price_to_asset_ratio": 0.54,
            "price_to_current_assets_ratio": 3.21,
            "price_to_free_cash_flow_ratio": 2.54,
            "ev_to_ebitda": 2.1,
            "ev_to_ebit": 2.59
          },
          "leverage": {
            "current_ratio": 1,
            "equity_to_asset_ratio": 0.37,
            "debt_to_equity_ratio": 0.66,
            "net_debt_to_ebitda_ratio": 0.66,
            "net_debt_to_ebit_ratio": 0.81
          },
          "margins": {
            "gross_profit_margin": 52.1,
            "ebitda_margin": 56.52,
            "ebit_margin": 45.89,
            "net_profit_margin": 29.47
          },
          "profitability": {
            "asset_turnover_ratio": 0.66,
            "return_on_assets": 19.35,
            "return_on_equity": 51.87,
            "return_on_invested_capital": 24.88,
            "return_on_capital_employed": 36.19
          },
          "dividends": {
            "yield_percent": 7.21,
            "yield_currency": 2.756
          }
        },
        {
          "period_type": "annual",
          "start_date": "2021-01-01",
          "end_date": "2021-12-31",
          "fiscal_year": 2021,
          "fiscal_period": "FY",
          "valuation": {
            "enterprise_value": 793037000000,
            "ebitda": 273879000000,
            "earnings_per_share": 8.322,
            "book_value_per_share": 30.226,
            "price_to_earnings_ratio": 4.6,
            "peg_ratio": 0,
            "price_to_book_ratio": 1.27,
            "price_to_sales_ratio": 1.16,
            "price_to_ebitda": 1.91,
            "price_to_ebit": 2.48,
            "price_to_asset_ratio": 0.54,
            "price_to_current_assets_ratio": 3.11,
            "price_to_free_cash_flow_ratio": 3.1,
            "ev_to_ebitda": 2.9,
            "ev_to_ebit": 3.76
          },
          "leverage": {
            "current_ratio": 1.25,
            "equity_to_asset_ratio": 0.4,
            "debt_to_equity_ratio": 0.69,
            "net_debt_to_ebitda_ratio": 0.98,
            "net_debt_to_ebit_ratio": 1.28
          },
          "margins": {
            "gross_profit_margin": 48.52,
            "ebitda_margin": 60.5,
            "ebit_margin": 46.58,
            "net_profit_margin": 23.7
          },
          "profitability": {
            "asset_turnover_ratio": 0.46,
            "return_on_assets": 11.02,
            "return_on_equity": 27.53,
            "return_on_invested_capital": 17.8,
            "return_on_capital_employed": 25.16
          },
          "dividends": {
            "yield_percent": 0,
            "yield_currency": 0
          }
        },
        {
          "period_type": "annual",
          "start_date": "2020-01-01",
          "end_date": "2020-12-31",
          "fiscal_year": 2020,
          "fiscal_period": "FY",
          "valuation": {
            "enterprise_value": 855321000000,
            "ebitda": 107926000000,
            "earnings_per_share": 0.485,
            "book_value_per_share": 24.141,
            "price_to_earnings_ratio": 78.85,
            "peg_ratio": -0.93,
            "price_to_book_ratio": 1.58,
            "price_to_sales_ratio": 1.92,
            "price_to_ebitda": 4.85,
            "price_to_ebit": 10.55,
            "price_to_asset_ratio": 0.53,
            "price_to_current_assets_ratio": 3.68,
            "price_to_free_cash_flow_ratio": 4.43,
            "ev_to_ebitda": 7.93,
            "ev_to_ebit": 17.24
          },
          "leverage": {
            "current_ratio": 1.04,
            "equity_to_asset_ratio": 0.32,
            "debt_to_equity_ratio": 1.07,
            "net_debt_to_ebitda_ratio": 3.07,
            "net_debt_to_ebit_ratio": 6.68
          },
          "margins": {
            "gross_profit_margin": 45.56,
            "ebitda_margin": 39.67,
            "ebit_margin": 18.24,
            "net_profit_margin": 2.3
          },
          "profitability": {
            "asset_turnover_ratio": 0.28,
            "return_on_assets": 0.63,
            "return_on_equity": 2.01,
            "return_on_invested_capital": 984.17,
            "return_on_capital_employed": 5.83
          },
          "dividends": {
            "yield_percent": 0,
            "yield_currency": 0
          }
        },
        {
          "period_type": "annual",
          "start_date": "2019-01-01",
          "end_date": "2019-12-31",
          "fiscal_year": 2019,
          "fiscal_period": "FY",
          "valuation": {
            "enterprise_value": 845076000000,
            "ebitda": 140203000000,
            "earnings_per_share": 3.179,
            "book_value_per_share": 23.209,
            "price_to_earnings_ratio": 12.03,
            "price_to_book_ratio": 1.65,
            "price_to_sales_ratio": 1.73,
            "price_to_ebitda": 3.73,
            "price_to_ebit": 6.41,
            "price_to_asset_ratio": 0.57,
            "price_to_current_assets_ratio": 4.67,
            "price_to_free_cash_flow_ratio": 7.73,
            "ev_to_ebitda": 6.03,
            "ev_to_ebit": 10.34
          },
          "leverage": {
            "current_ratio": 0.97,
            "equity_to_asset_ratio": 0.32,
            "debt_to_equity_ratio": 1.07,
            "net_debt_to_ebitda_ratio": 2.29,
            "net_debt_to_ebit_ratio": 3.93
          },
          "margins": {
            "gross_profit_margin": 40.4,
            "ebitda_margin": 46.39,
            "ebit_margin": 27.03,
            "net_profit_margin": 13.56
          },
          "profitability": {
            "asset_turnover_ratio": 0.33,
            "return_on_assets": 4.42,
            "return_on_equity": 13.7,
            "return_on_invested_capital": 6.59,
            "return_on_capital_employed": 10.09
          },
          "dividends": {
            "yield_percent": 0,
            "yield_currency": 0
          }
        }
      ],
      "agents": [
        {
          "role": "transfer_agent",
          "name": "BRADESCO",
          "full_name": "BRADESCO"
        }
      ],
      "source": {
        "symbol": "B3",
        "name": "B3",
        "full_name": "B3 S.A. - Brasil, Bolsa, Balcão",
        "url": "https://www.b3.com.br",
        "location": {
          "timezone": "America/Sao_Paulo"
        }
      }
    }
  ]
}

Campos

Os dados de cada ativo retornam no array results:

Ativo

CampoTipoDescriçãoExemplo
tickerstringTicker completo no formato {fonte}:{símbolo}.B3:PETR4
kindstringTipo do ativo: stock, bdr, etf, fund, index etc.stock
unitstringUnidade dos valores (currency, points etc.).currency
currencystringMoeda dos valores.BRL
symbolstringCódigo de negociação do ativo.PETR4
namestringNome simplificado da empresa.Petrobras
full_namestringRazão social completa ou nome completo.Petróleo Brasileiro S.A. Petrobras
tax_idstringDocumento fiscal do emissor (ex.: CNPJ).33.000.167/0001-01
isinstringCódigo ISIN do ativo.BRPETRACNPR6
shares_outstandingnumberQuantidade de ações em circulação.13044496930

Cotação

O objeto quote traz a cotação base para os cálculos e métricas de mercado:

CampoTipoDescriçãoExemplo
valuenumberÚltimo valor negociado.47.90
change_valuenumberVariação absoluta no dia.1.29
change_percentnumberVariação percentual no dia.2.77
market_capnumberValor de mercado com base na cotação atual.624800000000
updated_atstringTimestamp de atualização da cotação (ISO 8601).2026-04-09T15:45:00-03:00
Devido ao grande volume de dados e complexidade dos cálculos, os resultados deste endpoint são cacheados por um período de até 30 minutos. Para utilizar a cotação com dados mais atualizados ou em tempo real, utilize o endpoint /v2/finance/quotes e combine as informações conforme necessário.

Período

Cada item do array statements representa os dados de um período:

CampoTipoDescriçãoExemplo
period_typestringTipo do período: annual, quarterly ou ttm.ttm
start_datestringData de início do período.2025-01-01
end_datestringData de encerramento do período.2025-12-31
fiscal_yearnumberAno fiscal.2025
fiscal_periodstringPeríodo fiscal: FY, TTM ou Q1Q4.TTM

Dividendos

O objeto dividends traz o retorno em proventos do período:

CampoTipoDescriçãoExemplo
yield_percentnumberDividend Yield acumulado no período (%).13.28
yield_currencynumberValor total distribuído por ação no período.6.36

Indicadores

Os campos dos grupos valuation, leverage, margins e profitability detalham a saúde financeira da empresa:

Valuation
CampoTipoDescriçãoExemplo
valuation.price_to_earnings_rationumberMúltiplo Preço/Lucro (P/L).5.65
valuation.peg_rationumberPEG Ratio.0.74
valuation.price_to_book_rationumberMúltiplo Preço/Valor Patrimonial (P/VP).1.50
valuation.price_to_sales_rationumberMúltiplo Preço/Receita.1.26
valuation.price_to_ebitdanumberMúltiplo Preço/EBITDA.3.74
valuation.price_to_ebitnumberMúltiplo Preço/EBIT.4.35
valuation.price_to_asset_rationumberMúltiplo Preço/Ativos.0.56
valuation.price_to_current_assets_rationumberMúltiplo Preço/Ativo Circulante.4.47
valuation.price_to_free_cash_flow_rationumberMúltiplo Preço/Fluxo de Caixa Livre.6.02
valuation.ev_to_ebitdanumberMúltiplo EV/EBITDA.3.98
valuation.ev_to_ebitnumberMúltiplo EV/EBIT.4.62
Endividamento
CampoTipoDescriçãoExemplo
leverage.current_rationumberÍndice de Liquidez Corrente.1.18
leverage.equity_to_asset_rationumberRelação Patrimônio Líquido/Ativos.0.33
leverage.debt_to_equity_rationumberRelação Dívida Líquida/Patrimônio Líquido.0.34
leverage.net_debt_to_ebitda_rationumberRelação Dívida Líquida/EBITDA.0.24
leverage.net_debt_to_ebit_rationumberRelação Dívida Líquida/EBIT.0.28
Margens
CampoTipoDescriçãoExemplo
margins.gross_profit_marginnumberMargem bruta (%).50.62
margins.ebitda_marginnumberMargem EBITDA (%).40.53
margins.ebit_marginnumberMargem EBIT (%).35.27
margins.net_profit_marginnumberMargem líquida (%).22.25
Rentabilidade e Eficiência
CampoTipoDescriçãoExemplo
profitability.asset_turnover_rationumberGiro de ativos.0.70
profitability.return_on_assetsnumberRetorno sobre ativos (ROA) (%).8.73
profitability.return_on_equitynumberRetorno sobre patrimônio líquido (ROE) (%).26.47
profitability.return_on_invested_capitalnumberRetorno sobre capital investido (ROIC) (%).18.92
profitability.return_on_capital_employednumberRetorno sobre capital empregado (ROCE) (%).22.47

Agentes

O array agents traz informações sobre os agentes relacionados ao ativo, como o agente de transferência (escriturador):

CampoTipoDescriçãoExemplo
rolestringPapel do agente (ex.: transfer_agent).transfer_agent
namestringNome simplificado do agente.Bradesco
full_namestringRazão social do agente.Banco Bradesco S.A.
urlstringURL oficial do agente.https://www.bradesco.com.br/

Fonte

O objeto source contém informações sobre a bolsa de valores onde o ativo é negociado:

CampoTipoDescriçãoExemplo
source.symbolstringCódigo da bolsa.B3
source.namestringNome da bolsa.B3 - Brasil, Bolsa, Balcão
source.full_namestringNome completo da bolsa.B3 S.A. - Brasil, Bolsa, Balcão
source.urlstringSite oficial da bolsa.https://www.b3.com.br/
source.location.timezonestringFuso horário da bolsa.America/Sao_Paulo