Índices
Finance
Cotações dos principais índices do mercado financeiro.
Obtenha as cotações dos principais Índices do mercado financeiro, como o Ibovespa e outros índices relevantes.
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.
Índices
Abaixo, 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
O endpoint /v2/finance/quotes retorna cotações com payload enxuto e baixa latência, ideal para atualização frequente de valor.
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
tickers
string required
Ticker do ativo no formato
{fonte}:{símbolo}. As fontes de índices incluem: INDEXB3, INDEXNASDAQ, INDEXNYSE, INDEXTYO, INDEXEURONEXT, entre outras. Para múltiplos ativos, separe por vírgula: INDEXB3:IBOV,INDEXNASDAQ:IXIC,INDEXNYSE:SPX.fields
string
Filtro de campos para reduzir o payload de retorno. Ex:
ticker,quote.value,quote.change_percent.Resposta
Nos results, a API retorna os dados da seguinte forma:
{
"metadata": {
"key_status": "valid",
"cached": false,
"response_time_ms": 96.4,
"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": 195956,
"change_value": -862.26,
"change_percent": -0.4381,
"updated_at": "2026-04-17T11:57:30-03:00"
},
"market": {
"is_open": true,
"open_time": "2026-04-17T10:000-3:00",
"close_time": "2026-04-17T17:300-3:00",
"previous_value": 196819,
"open": 196881,
"close": 195956,
"high": 198666,
"low": 195548,
"volume": 0,
"updated_at": "2026-04-17T11:57:30-03:00"
},
"source": {
"symbol": "INDEXB3",
"name": "INDEXB3",
"full_name": "Índices da B3",
"url": "https://www.b3.com.br",
"location": {
"timezone": "America/Sao_Paulo"
}
},
"related": []
}
]
}
Campos
Consulte a documentação completa dos campos retornados em Ações.