Índices

HG BrasilFinance
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.

Índices

Abaixo, alguns exemplos dos principais índices globais e como você deve solicitar no endpoint (utilizando o formato {fonte}:{símbolo}):

FonteTickerÍndice (Descrição)
INDEXB3INDEXB3:IBOVIbovespa (B3 - Brasil)
INDEXB3INDEXB3:IFIXÍndice de Fundos de Investimentos Imobiliários (IFIX)
INDEXNASDAQINDEXNASDAQ:IXICNASDAQ Composite (EUA)
INDEXNYSEINDEXNYSE:DJIDow Jones Industrial Average (EUA)
INDEXNYSEINDEXNYSE:SPXS&P 500 (EUA)
INDEXTYOINDEXTYO:N225Nikkei 225 (Tóquio, Japão)
INDEXEURONEXTINDEXEURONEXT:FCHICAC 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.

GET
https://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"

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.