Dados Fundamentalistas

Finance

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

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": false,
    "response_time_ms": 79.9,
    "language": "pt-br"
  },
  "results": [
    {
      "ticker": "B3:PETR4",
      "unit": "currency",
      "currency": "BRL",
      "symbol": "PETR4",
      "name": "Petrobrás",
      "full_name": "Petroleo Brasileiro S.A. Petrobras",
      "tax_id": "33.000.167/0001-01",
      "market": {
        "is_open": false,
        "date": "2026-04-10T17:07:30-03:00",
        "value": 49.03,
        "change_value": 1.13,
        "change_percent": 2.36,
        "previous_value": 47.9,
        "volume": 42860900,
        "market_cap": 668424000000,
        "shares_outstanding": 12888732761
      },
      "statements": [
        {
          "period_type": "ttm",
          "start_date": "2025-01-01",
          "end_date": "2025-12-31",
          "fiscal_year": 2025,
          "fiscal_period": "TTM",
          "valuation": {
            "enterprise_value": 1016841000000,
            "ebitda": 145628000000,
            "earnings_per_share": 8.582,
            "book_value_per_share": 32.399,
            "price_to_earnings_ratio": 5.71,
            "price_to_book_ratio": 1.51,
            "price_to_sales_ratio": 1.34,
            "price_to_ebitda": 4.59,
            "price_to_ebit": 4.59,
            "price_to_asset_ratio": 0.55,
            "price_to_current_assets_ratio": 4.77,
            "ev_to_ebitda": 6.98,
            "ev_to_ebit": 6.98
          },
          "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_12m_percent": 6.673,
            "yield_12m_currency": 3.272
          }
        },
        {
          "period_type": "annual",
          "start_date": "2025-01-01",
          "end_date": "2025-12-31",
          "fiscal_year": 2025,
          "fiscal_period": "FY",
          "valuation": {
            "enterprise_value": 1016841000000,
            "ebitda": 230016000000,
            "earnings_per_share": 8.582,
            "book_value_per_share": 32.399,
            "price_to_earnings_ratio": 5.71,
            "peg_ratio": 0.03,
            "price_to_book_ratio": 1.51,
            "price_to_sales_ratio": 1.34,
            "price_to_ebitda": 2.91,
            "price_to_ebit": 4.59,
            "price_to_asset_ratio": 0.55,
            "price_to_current_assets_ratio": 4.77,
            "price_to_free_cash_flow_ratio": 7.3,
            "ev_to_ebitda": 4.42,
            "ev_to_ebit": 6.98
          },
          "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_12m_percent": 6.673,
            "yield_12m_currency": 3.272
          }
        },
        {
          "period_type": "annual",
          "start_date": "2024-01-01",
          "end_date": "2024-12-31",
          "fiscal_year": 2024,
          "fiscal_period": "FY",
          "valuation": {
            "enterprise_value": 1021637000000,
            "ebitda": 204234000000,
            "earnings_per_share": 2.871,
            "book_value_per_share": 28.514,
            "price_to_earnings_ratio": 17.08,
            "price_to_book_ratio": 1.72,
            "price_to_sales_ratio": 1.36,
            "price_to_ebitda": 3.27,
            "price_to_ebit": 4.87,
            "price_to_asset_ratio": 0.59,
            "price_to_current_assets_ratio": 4.94,
            "price_to_free_cash_flow_ratio": 5.38,
            "ev_to_ebitda": 5,
            "ev_to_ebit": 7.45
          },
          "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_12m_percent": 6.673,
            "yield_12m_currency": 3.272
          }
        }
      ],
      "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
`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. Petrobras
`tax_id`	`string`	Documento fiscal do emissor (ex.: CNPJ).	33.000.167/0001-01
`isin`	`string`	Código ISIN do ativo.	BRPETRACNPR6

Mercado

O objeto market traz a cotação mais recente e métricas de mercado em tempo real:

Campo	Tipo	Descrição	Exemplo
`is_open`	`boolean`	Indica se o mercado está aberto no momento da consulta.	true
`date`	`string`	Data e hora de referência da cotação.	2026-04-09T15:30:00-03:00
`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
`previous_value`	`number`	Valor de referência anterior (geralmente o fechamento do pregão anterior).	46.61
`volume`	`number`	Volume financeiro negociado no dia.	35420000
`market_cap`	`number`	Valor de mercado com base na cotação atual.	624800000000
`shares_outstanding`	`number`	Total de ações em circulação.	13044496930

Período

Cada item do array statements representa os indicadores fundamentalistas 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

Valuation

O objeto valuation reúne indicadores que ajudam a avaliar o preço do ativo em relação aos seus resultados e patrimônio:

Campo	Tipo	Descrição
`enterprise_value`	`number`	Enterprise Value (EV) — valor econômico da empresa considerando dívida e caixa.
`ebitda`	`number`	EBITDA do período, utilizado como base para os múltiplos.
`earnings_per_share`	`number`	Lucro por ação (LPA) atribuído ao acionista.
`book_value_per_share`	`number`	Valor patrimonial por ação (VPA).
`price_to_earnings_ratio`	`number`	Múltiplo Preço/Lucro (P/L).
`peg_ratio`	`number`	PEG Ratio — P/L ajustado pelo crescimento do lucro.
`price_to_book_ratio`	`number`	Múltiplo Preço/Valor Patrimonial (P/VP).
`price_to_sales_ratio`	`number`	Múltiplo Preço/Receita (P/S).
`price_to_ebitda`	`number`	Múltiplo Preço/EBITDA.
`price_to_ebit`	`number`	Múltiplo Preço/EBIT.
`price_to_asset_ratio`	`number`	Múltiplo Preço/Ativos.
`price_to_current_assets_ratio`	`number`	Múltiplo Preço/Ativo Circulante.
`price_to_free_cash_flow_ratio`	`number`	Múltiplo Preço/Fluxo de Caixa Livre.
`ev_to_ebitda`	`number`	Múltiplo EV/EBITDA.
`ev_to_ebit`	`number`	Múltiplo EV/EBIT.

Endividamento

O objeto leverage mede a alavancagem e a solidez financeira da empresa:

Campo	Tipo	Descrição
`current_ratio`	`number`	Índice de Liquidez Corrente — capacidade de honrar obrigações de curto prazo.
`equity_to_asset_ratio`	`number`	Relação Patrimônio Líquido/Ativos — parcela dos ativos financiada por capital próprio.
`debt_to_equity_ratio`	`number`	Relação Dívida Líquida/Patrimônio Líquido.
`net_debt_to_ebitda_ratio`	`number`	Relação Dívida Líquida/EBITDA — quantos anos de geração de caixa seriam necessários para quitar a dívida.
`net_debt_to_ebit_ratio`	`number`	Relação Dívida Líquida/EBIT.

Margens

O objeto margins mostra, em termos percentuais, o quanto de cada real de receita vira lucro em cada etapa da DRE:

Campo	Tipo	Descrição
`gross_profit_margin`	`number`	Margem bruta (%).
`ebitda_margin`	`number`	Margem EBITDA (%).
`ebit_margin`	`number`	Margem EBIT (%) — margem operacional.
`net_profit_margin`	`number`	Margem líquida (%).

Rentabilidade

O objeto profitability avalia a eficiência com que a empresa transforma capital em resultado:

Campo	Tipo	Descrição
`asset_turnover_ratio`	`number`	Giro de ativos — receita gerada por real investido em ativos.
`return_on_assets`	`number`	Retorno sobre ativos (ROA) em percentual.
`return_on_equity`	`number`	Retorno sobre patrimônio líquido (ROE) em percentual.
`return_on_invested_capital`	`number`	Retorno sobre capital investido (ROIC) em percentual.
`return_on_capital_employed`	`number`	Retorno sobre capital empregado (ROCE) em percentual.

Dividendos

O objeto dividends traz o retorno em proventos dos últimos 12 meses:

Campo	Tipo	Descrição	Exemplo
`yield_12m_percent`	`number`	Dividend Yield acumulado em 12 meses (%).	13.28
`yield_12m_currency`	`number`	Valor total distribuído por ação nos últimos 12 meses.	6.36

Indicadores podem retornar null quando não há dados suficientes para o cálculo (por exemplo, quando a empresa não reportou os itens necessários no período).

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.