Índices

HG BrasilFinance
Cotações dos principais índices do mercado financeiro e composição do Ibovespa.

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.

Principais índices

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

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:

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
Lista de índices no formato {fonte}:{símbolo} separados por vírgula. Ex.: INDEXB3:IBOV,INDEXNASDAQ:IXIC. Não pode ser usado em conjunto com components.
components
string
Retorna os ativos que compõem um índice em vez da cotação do próprio índice. Atualmente aceita apenas INDEXB3:BVSP e INDEXB3:IBOV. Requer plano Pro, equivalente ou superior. Não pode ser usado em conjunto com tickers.
sort
string
Ordena os resultados com base em um campo de retorno. Aceita: 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.
page
integer
Página da lista retornada por components. Começa em 1 (padrão). A quantidade de itens por página depende do limite de ativos do seu plano.
fields
string
Filtro de campos para reduzir o payload de retorno. Ex.: ticker,quote.value,quote.change_percent. Em breve.
É obrigatório informar 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:

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

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

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

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

CampoDescrição
tickerIdentificador completo no formato {source}:{symbol}
kindTipo do ativo: stock, bdr, etf, fund, index, crypto, forex
unitUnidade dos valores (currency, points etc.)
currencyMoeda principal
symbolCódigo de negociação
nameNome simplificado
full_nameNome completo ou razão social
tax_idDocumento fiscal do emissor (ex.: CNPJ)
isinCódigo ISIN do ativo
shares_outstandingQuantidade de ações em circulação
classification.sectorSetor de atuação
classification.subsectorSubsetor de atuação
classification.segmentSegmento de atuação
logos.square_smallURL do logotipo quadrado em tamanho pequeno
logos.square_largeURL do logotipo quadrado em tamanho grande
relatedLista de tickers relacionados no formato {source}:{symbol}

Quote

CampoDescrição
quote.valueÚltimo valor negociado (moeda, pontos etc.)
quote.change_valueVariação absoluta no dia
quote.change_percentVariação percentual no dia
quote.market_capValor de mercado com base na cotação atual
quote.updated_atTimestamp da cotação (ISO 8601)

Market

CampoDescrição
market.is_openIndica se o mercado está aberto
market.open_timeHorário de abertura do mercado (ISO 8601)
market.close_timeHorário de fechamento do mercado (ISO 8601)
market.previous_valueValor de referência anterior (ex.: fechamento anterior)
market.openValor de abertura do dia
market.highMáxima do dia
market.lowMínima do dia
market.closeValor de fechamento do dia
market.volumeVolume negociado
market.updated_atTimestamp da sessão (ISO 8601)

Dividends

CampoDescrição
dividends.yield_12m_percentDividend yield dos últimos 12 meses em percentual
dividends.yield_12m_cashDividend yield dos últimos 12 meses em valor absoluto (moeda)

Fonte

CampoDescrição
source.symbolCódigo da fonte
source.nameNome da fonte
source.full_nameNome completo da fonte
source.urlSite oficial
source.location.timezoneFuso horário