Dados Fundamentalistas

Finance

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:

Grupo	O que mede
Valuation	Se o ativo está barato ou caro em relação aos seus resultados e patrimônio.
Endividamento	O nível de alavancagem e a capacidade de honrar obrigações.
Margens	A eficiência em transformar receita em lucro.
Rentabilidade	O retorno gerado sobre ativos, patrimônio e capital investido.
Dividendos	O 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.

`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/fundamentals?tickers=B3:PETR4&key=suachave

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

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

$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/fundamentals'

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/fundamentals')

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

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.

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": true,
    "response_time_ms": 0,
    "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": 45.67,
        "change_value": -0.55,
        "change_percent": -1.19,
        "market_cap": 620469000000,
        "updated_at": "2026-05-08T17:07:31-03:00"
      },
      "statements": [
        {
          "period_type": "ttm",
          "start_date": "2025-01-01",
          "end_date": "2025-12-31",
          "fiscal_year": 2025,
          "fiscal_period": "TTM",
          "valuation": {
            "enterprise_value": 968886000000,
            "ebitda": 145628000000,
            "earnings_per_share": 8.582,
            "book_value_per_share": 32.399,
            "price_to_earnings_ratio": 5.32,
            "price_to_book_ratio": 1.41,
            "price_to_sales_ratio": 1.25,
            "price_to_ebitda": 4.26,
            "price_to_ebit": 4.26,
            "price_to_asset_ratio": 0.51,
            "price_to_current_assets_ratio": 4.43,
            "ev_to_ebitda": 6.65,
            "ev_to_ebit": 6.65
          },
          "leverage": {
            "current_ratio": 0.71,
            "equity_to_asset_ratio": 0.34,
            "debt_to_equity_ratio": 0.83,
            "net_debt_to_ebitda_ratio": 2.39,
            "net_debt_to_ebit_ratio": 2.39
          },
          "margins": {
            "gross_profit_margin": 47.63,
            "ebitda_margin": 29.27,
            "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": 6.34,
            "yield_currency": 2.896
          }
        },
        {
          "period_type": "annual",
          "start_date": "2025-01-01",
          "end_date": "2025-12-31",
          "fiscal_year": 2025,
          "fiscal_period": "FY",
          "valuation": {
            "enterprise_value": 968886000000,
            "ebitda": 230016000000,
            "earnings_per_share": 8.582,
            "book_value_per_share": 32.399,
            "price_to_earnings_ratio": 5.32,
            "peg_ratio": 0.03,
            "price_to_book_ratio": 1.41,
            "price_to_sales_ratio": 1.25,
            "price_to_ebitda": 2.7,
            "price_to_ebit": 4.26,
            "price_to_asset_ratio": 0.51,
            "price_to_current_assets_ratio": 4.43,
            "price_to_free_cash_flow_ratio": 6.77,
            "ev_to_ebitda": 4.21,
            "ev_to_ebit": 6.65
          },
          "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": 6.34,
            "yield_currency": 2.896
          }
        },
        {
          "period_type": "annual",
          "start_date": "2024-01-01",
          "end_date": "2024-12-31",
          "fiscal_year": 2024,
          "fiscal_period": "FY",
          "valuation": {
            "enterprise_value": 973682000000,
            "ebitda": 204234000000,
            "earnings_per_share": 2.871,
            "book_value_per_share": 28.514,
            "price_to_earnings_ratio": 15.91,
            "price_to_book_ratio": 1.6,
            "price_to_sales_ratio": 1.26,
            "price_to_ebitda": 3.04,
            "price_to_ebit": 4.52,
            "price_to_asset_ratio": 0.55,
            "price_to_current_assets_ratio": 4.59,
            "price_to_free_cash_flow_ratio": 5,
            "ev_to_ebitda": 4.77,
            "ev_to_ebit": 7.1
          },
          "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.44,
            "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
          }
        }
      ],
      "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

Campo	Tipo	Descrição	Exemplo
`ticker`	`string`	Ticker completo no formato `{fonte}:{símbolo}`.	B3:PETR4
`kind`	`string`	Tipo do ativo: `stock`, `bdr`, `etf`, `fund`, `index` etc.	stock
`unit`	`string`	Unidade dos valores (`currency`, `points` etc.).	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 ou nome completo.	Petróleo Brasileiro S.A. Petrobras
`tax_id`	`string`	Documento fiscal do emissor (ex.: CNPJ).	33.000.167/0001-01
`isin`	`string`	Código ISIN do ativo.	BRPETRACNPR6
`shares_outstanding`	`number`	Quantidade 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:

Campo	Tipo	Descrição	Exemplo
`value`	`number`	Último valor negociado.	47.90
`change_value`	`number`	Variação absoluta no dia.	1.29
`change_percent`	`number`	Variação percentual no dia.	2.77
`market_cap`	`number`	Valor de mercado com base na cotação atual.	624800000000
`updated_at`	`string`	Timestamp 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:

Campo	Tipo	Descrição	Exemplo
`period_type`	`string`	Tipo do período: `annual`, `quarterly` ou `ttm`.	ttm
`start_date`	`string`	Data de início do período.	2025-01-01
`end_date`	`string`	Data de encerramento do período.	2025-12-31
`fiscal_year`	`number`	Ano fiscal.	2025
`fiscal_period`	`string`	Período fiscal: `FY`, `TTM` ou `Q1`–`Q4`.	TTM

Dividendos

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

Campo	Tipo	Descrição	Exemplo
`yield_percent`	`number`	Dividend Yield acumulado no período (%).	13.28
`yield_currency`	`number`	Valor 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

Campo	Tipo	Descrição	Exemplo
`valuation.price_to_earnings_ratio`	`number`	Múltiplo Preço/Lucro (P/L).	5.65
`valuation.peg_ratio`	`number`	PEG Ratio.	0.74
`valuation.price_to_book_ratio`	`number`	Múltiplo Preço/Valor Patrimonial (P/VP).	1.50
`valuation.price_to_sales_ratio`	`number`	Múltiplo Preço/Receita.	1.26
`valuation.price_to_ebitda`	`number`	Múltiplo Preço/EBITDA.	3.74
`valuation.price_to_ebit`	`number`	Múltiplo Preço/EBIT.	4.35
`valuation.price_to_asset_ratio`	`number`	Múltiplo Preço/Ativos.	0.56
`valuation.price_to_current_assets_ratio`	`number`	Múltiplo Preço/Ativo Circulante.	4.47
`valuation.price_to_free_cash_flow_ratio`	`number`	Múltiplo Preço/Fluxo de Caixa Livre.	6.02
`valuation.ev_to_ebitda`	`number`	Múltiplo EV/EBITDA.	3.98
`valuation.ev_to_ebit`	`number`	Múltiplo EV/EBIT.	4.62

Endividamento

Campo	Tipo	Descrição	Exemplo
`leverage.current_ratio`	`number`	Índice de Liquidez Corrente.	1.18
`leverage.equity_to_asset_ratio`	`number`	Relação Patrimônio Líquido/Ativos.	0.33
`leverage.debt_to_equity_ratio`	`number`	Relação Dívida Líquida/Patrimônio Líquido.	0.34
`leverage.net_debt_to_ebitda_ratio`	`number`	Relação Dívida Líquida/EBITDA.	0.24
`leverage.net_debt_to_ebit_ratio`	`number`	Relação Dívida Líquida/EBIT.	0.28

Margens

Campo	Tipo	Descrição	Exemplo
`margins.gross_profit_margin`	`number`	Margem bruta (%).	50.62
`margins.ebitda_margin`	`number`	Margem EBITDA (%).	40.53
`margins.ebit_margin`	`number`	Margem EBIT (%).	35.27
`margins.net_profit_margin`	`number`	Margem líquida (%).	22.25

Rentabilidade e Eficiência

Campo	Tipo	Descrição	Exemplo
`profitability.asset_turnover_ratio`	`number`	Giro de ativos.	0.70
`profitability.return_on_assets`	`number`	Retorno sobre ativos (ROA) (%).	8.73
`profitability.return_on_equity`	`number`	Retorno sobre patrimônio líquido (ROE) (%).	26.47
`profitability.return_on_invested_capital`	`number`	Retorno sobre capital investido (ROIC) (%).	18.92
`profitability.return_on_capital_employed`	`number`	Retorno 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):

Campo	Tipo	Descrição	Exemplo
`role`	`string`	Papel do agente (ex.: `transfer_agent`).	transfer_agent
`name`	`string`	Nome simplificado do agente.	Bradesco
`full_name`	`string`	Razão social do agente.	Banco Bradesco S.A.
`url`	`string`	URL 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:

Campo	Tipo	Descrição	Exemplo
`source.symbol`	`string`	Código da bolsa.	B3
`source.name`	`string`	Nome da bolsa.	B3 - Brasil, Bolsa, Balcão
`source.full_name`	`string`	Nome completo da bolsa.	B3 S.A. - Brasil, Bolsa, Balcão
`source.url`	`string`	Site oficial da bolsa.	https://www.b3.com.br/
`source.location.timezone`	`string`	Fuso horário da bolsa.	America/Sao_Paulo

Grupamentos e Desdobramentos

Consulte grupamentos e desdobramentos de ações, fundos imobiliários e BDRs negociados na B3 (Ibovespa).

Balanço Patrimonial

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