Índices
Obtenha as cotações dos principais índices do mercado financeiro, como o Ibovespa, IFIX, S&P 500 e outros índices globais relevantes. Também é possível consultar os ativos que compõem um índice.
Ativos
Consulte os índices disponíveis e seus respectivos tickers para utilizar na consulta abaixo.
Ativos Disponíveis
Consulte os ativos disponíveis para uso na API. Use o campo abaixo para buscar por nome ou símbolo.
Principais índices
Alguns exemplos dos principais índices globais e como você deve solicitar no endpoint (utilizando o formato {fonte}:{símbolo}):
| Fonte | Ticker | Índice (Descrição) |
|---|---|---|
| INDEXB3 | INDEXB3:IBOV | Ibovespa (B3 - Brasil) |
| INDEXB3 | INDEXB3:IFIX | Índice de Fundos de Investimentos Imobiliários (IFIX) |
| INDEXNASDAQ | INDEXNASDAQ:IXIC | NASDAQ Composite (EUA) |
| INDEXNYSE | INDEXNYSE:DJI | Dow Jones Industrial Average (EUA) |
| INDEXNYSE | INDEXNYSE:SPX | S&P 500 (EUA) |
| INDEXTYO | INDEXTYO:N225 | Nikkei 225 (Tóquio, Japão) |
| INDEXEURONEXT | INDEXEURONEXT:FCHI | CAC 40 (Euronext Paris, França) |
Requisição
Para consultar a cotação de um ou mais índices, informe os tickers no formato {fonte}:{símbolo} separados por vírgula. Por exemplo, para consultar Ibovespa e NASDAQ:
GEThttps://api.hgbrasil.com/v2/finance/quotes?tickers=INDEXB3:IBOV,INDEXNASDAQ:IXIC&key=suachave
curl -X GET "https://api.hgbrasil.com/v2/finance/quotes?tickers=INDEXB3%3AIBOV%2CINDEXNASDAQ%3AIXIC&key=suachave"
const url = new URL("/v2/finance/quotes", "https://api.hgbrasil.com")
url.searchParams.set("tickers", "INDEXB3:IBOV,INDEXNASDAQ:IXIC")
url.searchParams.set("key", "suachave")
const response = await fetch(url.href)
const data = await response.json()
$url = 'https://api.hgbrasil.com/v2/finance/quotes';
$queryString = http_build_query([
'tickers' => 'INDEXB3:IBOV,INDEXNASDAQ:IXIC',
'key' => 'suachave'
]);
$response = file_get_contents($url . '?' . $queryString);
$data = json_decode($response, true);
import requests
url = 'https://api.hgbrasil.com/v2/finance/quotes'
params = {
'tickers': 'INDEXB3:IBOV,INDEXNASDAQ:IXIC',
'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/quotes')
uri.query = URI.encode_www_form({
tickers: 'INDEXB3:IBOV,INDEXNASDAQ:IXIC',
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/quotes?tickers=INDEXB3%3AIBOV%2CINDEXNASDAQ%3AIXIC&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/quotes";
var queryParams = HttpUtility.ParseQueryString(string.Empty);
queryParams["tickers"] = "INDEXB3:IBOV,INDEXNASDAQ:IXIC";
queryParams["key"] = "suachave";
var url = $"{baseUrl}?{queryParams}";
var response = await client.GetStringAsync(url);
var data = JsonSerializer.Deserialize<dynamic>(response);
Parâmetros
{fonte}:{símbolo} separados por vírgula. Ex.: INDEXB3:IBOV,INDEXNASDAQ:IXIC. Não pode ser usado em conjunto com components.INDEXB3:BVSP e INDEXB3:IBOV. Requer plano Pro, equivalente ou superior. Não pode ser usado em conjunto com tickers.value:asc, value:desc, volume:asc, volume:desc, change_percent:asc, change_percent:desc. Quando usado com components, a ordenação é aplicada antes do limite da página.components. Começa em 1 (padrão). A quantidade de itens por página depende do limite de ativos do seu plano.ticker,quote.value,quote.change_percent. Em breve.tickersoucomponents, mas não os dois ao mesmo tempo.Altas e Baixas do Ibovespa
Com o parâmetro components você consulta os ativos que compõem um índice e descobre, em uma única requisição, quem está puxando o índice para cima ou para baixo no dia.
Maiores altas do dia
Combine components com sort=change_percent:desc para listar os papéis em maior alta:
GEThttps://api.hgbrasil.com/v2/finance/quotes?components=INDEXB3:BVSP&sort=change_percent:desc&key=suachave
Maiores baixas do dia
Inverta a ordenação para change_percent:asc e veja os papéis em maior queda:
GEThttps://api.hgbrasil.com/v2/finance/quotes?components=INDEXB3:BVSP&sort=change_percent:asc&key=suachave
Mais negociados
Ordene por volume para identificar os ativos com maior liquidez na sessão:
GEThttps://api.hgbrasil.com/v2/finance/quotes?components=INDEXB3:BVSP&sort=volume:desc&key=suachave
Composição completa
Para percorrer todos os componentes do índice, omita o sort e use page para navegar.
GEThttps://api.hgbrasil.com/v2/finance/quotes?components=INDEXB3:BVSP&page=2&key=suachave
Resposta
Nos results, a API retorna os dados da seguinte forma:
{
"metadata": {
"key_status": "valid",
"cached": true,
"response_time_ms": 0,
"language": "pt-br"
},
"results": [
{
"ticker": "INDEXB3:BVSP",
"kind": "index",
"unit": "currency",
"currency": "POINTS",
"symbol": "BVSP",
"name": "Índice Bovespa (Ibovespa)",
"logos": {
"square_small": "https://assets.hgbrasil.com/finance/companies/small/bvsp.png",
"square_large": "https://assets.hgbrasil.com/finance/companies/big/bvsp.png"
},
"quote": {
"value": 177284,
"change_value": -1081.97,
"change_percent": -0.6066,
"updated_at": "2026-05-15T19:37:42-03:00"
},
"market": {
"is_open": false,
"open_time": "2026-05-17T10:000-3:00",
"close_time": "2026-05-17T17:300-3:00",
"previous_value": 178366,
"open": 178341,
"close": 177284,
"high": 178341,
"low": 175417,
"volume": 0,
"updated_at": "2026-05-15T19:37:42-03:00"
},
"dividends": {
"yield_12m_percent": 0,
"yield_12m_cash": 0
},
"source": {
"symbol": "INDEXB3",
"name": "INDEXB3",
"full_name": "Índices da B3",
"url": "https://www.b3.com.br",
"location": {
"timezone": "America/Sao_Paulo"
}
},
"related": []
}
]
}
Campos
Os dados do ativo retornam dentro da lista results com os seguintes campos:
Ativo
| Campo | Descrição |
|---|---|
ticker | Identificador completo no formato {source}:{symbol} |
kind | Tipo do ativo: stock, bdr, etf, fund, index, crypto, forex |
unit | Unidade dos valores (currency, points etc.) |
currency | Moeda principal |
symbol | Código de negociação |
name | Nome simplificado |
full_name | Nome completo ou razão social |
tax_id | Documento fiscal do emissor (ex.: CNPJ) |
isin | Código ISIN do ativo |
shares_outstanding | Quantidade de ações em circulação |
classification.sector | Setor de atuação |
classification.subsector | Subsetor de atuação |
classification.segment | Segmento de atuação |
logos.square_small | URL do logotipo quadrado em tamanho pequeno |
logos.square_large | URL do logotipo quadrado em tamanho grande |
related | Lista de tickers relacionados no formato {source}:{symbol} |
Quote
| Campo | Descrição |
|---|---|
quote.value | Último valor negociado (moeda, pontos etc.) |
quote.change_value | Variação absoluta no dia |
quote.change_percent | Variação percentual no dia |
quote.market_cap | Valor de mercado com base na cotação atual |
quote.updated_at | Timestamp da cotação (ISO 8601) |
Market
| Campo | Descrição |
|---|---|
market.is_open | Indica se o mercado está aberto |
market.open_time | Horário de abertura do mercado (ISO 8601) |
market.close_time | Horário de fechamento do mercado (ISO 8601) |
market.previous_value | Valor de referência anterior (ex.: fechamento anterior) |
market.open | Valor de abertura do dia |
market.high | Máxima do dia |
market.low | Mínima do dia |
market.close | Valor de fechamento do dia |
market.volume | Volume negociado |
market.updated_at | Timestamp da sessão (ISO 8601) |
Dividends
| Campo | Descrição |
|---|---|
dividends.yield_12m_percent | Dividend yield dos últimos 12 meses em percentual |
dividends.yield_12m_cash | Dividend yield dos últimos 12 meses em valor absoluto (moeda) |
Fonte
| Campo | Descrição |
|---|---|
source.symbol | Código da fonte |
source.name | Nome da fonte |
source.full_name | Nome completo da fonte |
source.url | Site oficial |
source.location.timezone | Fuso horário |