Índices

Consulte rankings prontos com as maiores altas e maiores baixas entre os ativos que compõem índices de referência da B3, como IBOV, SMLL e IFIX.

O módulo de Índices da Partnr permite identificar quais componentes de um índice apresentam os melhores e os piores desempenhos durante o pregão. Os resultados utilizam a base de cotações da Partnr, com atualização D+0 e 15 minutos de atraso.

Em vez de consultar individualmente todos os ativos, calcular suas variações e ordenar os resultados, sua aplicação pode obter o ranking pronto por meio de uma única requisição à API.

O que é um índice de mercado?

Um índice de mercado representa o desempenho de um conjunto de ativos selecionados de acordo com uma metodologia específica.

O Ibovespa, identificado pelo símbolo IBOV, é utilizado como uma das principais referências do mercado acionário brasileiro. Outros índices representam segmentos ou categorias específicas, como empresas de menor capitalização e fundos imobiliários.

No módulo de Índices, o símbolo determina o universo de ativos considerado no ranking. Ao consultar o IBOV, por exemplo, a API analisa somente os ativos associados àquele índice e retorna os que apresentam as maiores variações positivas ou negativas.

Os exemplos documentados atualmente incluem:

• IBOV: Ibovespa
• SMLL: Índice Small Cap
• IFIX: Índice de Fundos de Investimentos Imobiliários

Utilize o símbolo do índice no parâmetro indexSymbol da URL.

O que você pode consultar?

O módulo possui duas rotas principais.

Maiores altas por índice

Retorna os ativos com melhor desempenho dentro do índice selecionado, ordenados da maior para a menor variação percentual.

GET /indexes/:indexSymbol/highs

Exemplo para consultar as cinco maiores altas do Ibovespa:

curl --request GET \
  --url "https://data.partnr.ai/v2/indexes/IBOV/highs?limit=5" \
  --header "Authorization: Bearer SUA_API_KEY"

Consulte a documentação completa de maiores altas.

Maiores baixas por índice

Retorna os ativos com pior desempenho dentro do índice selecionado, ordenados de acordo com as maiores variações negativas.

GET /indexes/:indexSymbol/lows

Exemplo para consultar as dez maiores baixas do IFIX:

curl --request GET \
  --url "https://data.partnr.ai/v2/indexes/IFIX/lows?limit=10" \
  --header "Authorization: Bearer SUA_API_KEY"

Consulte a documentação completa de maiores baixas.

Parâmetros disponíveis

As duas rotas utilizam os mesmos parâmetros.

Parâmetro	Local	Descrição	Obrigatório
indexSymbol	URL	Símbolo do índice, como IBOV, SMLL ou IFIX	Obrigatório
limit	Query	Quantidade máxima de ativos retornados	Opcional

Quando limit não é informado, a API retorna até dez ativos por padrão.

Por exemplo:

GET /indexes/SMLL/highs?limit=20

Essa requisição solicita os vinte ativos com melhor desempenho dentro do índice Small Cap.

Quais dados são retornados?

Além da posição e do ticker de cada ativo, o ranking apresenta informações que ajudam a interpretar o desempenho e a atividade de negociação.

Entre os campos disponíveis estão:

• Posição do ativo no ranking
• Ticker
• Preço considerado na apuração
• Variação percentual
• Variação em valor absoluto
• Maior preço do período
• Menor preço do período
• Quantidade negociada
• Volume financeiro
• Moeda dos valores
• Data e horário de atualização do ranking

A variação percentual é retornada em formato decimal. Um valor de 0.0621, por exemplo, representa uma alta de 6,21%. Uma variação de -0.0378 representa uma queda de 3,78%.

Exemplo simplificado de resposta:

{
  "updated_at": "2026-06-24T14:47:41.000Z",
  "ranking": [
    {
      "position": 1,
      "ticker": "ABCD3",
      "close_price": 18.75,
      "variation": 0.0325,
      "variation_value": 0.59,
      "highest_price": 18.9,
      "lowest_price": 18.1,
      "negotiated_quantity": 1250000,
      "volume": 23150000,
      "currency": "BRL"
    }
  ]
}

Consulte as páginas de cada endpoint para acessar a especificação completa dos campos, códigos de resposta e exemplos.

Atualização dos rankings

Os rankings utilizam cotações D+0 com 15 minutos de atraso. Por isso, a resposta representa uma visão atualizada do pregão, respeitando a defasagem informada, e não um fluxo de negociação em tempo real.

O campo updated_at mostra o timestamp da atualização utilizada no ranking. Ele pode ser armazenado ou exibido pela aplicação para informar ao usuário quando os dados foram processados.

Para relatórios de fechamento, análises históricas ou comparações com pregões anteriores, combine este módulo com os recursos de cotações históricas e variações D-1.

Diferença entre índice, cotação, variação e screener

A escolha do endpoint depende do resultado que sua aplicação precisa obter.

Recurso	Utilize quando precisar
Índices	Descobrir as maiores altas ou baixas entre os componentes de um índice
Cotações	Consultar preço, histórico ou gráfico de um ativo ou do próprio índice
Variações D-1	Identificar os destaques do pregão anterior em todo o mercado
Screener	Criar rankings personalizados usando seus próprios filtros e critérios

Consultar a cotação do IBOV, por exemplo, retorna o valor e a evolução do próprio índice. Consultar /indexes/IBOV/highs retorna os ativos do índice que mais subiram.

O módulo de Índices entrega rankings prontos. Já o Screener é indicado quando a classificação precisa considerar critérios adicionais, como liquidez, valuation, rentabilidade ou indicadores fundamentalistas.

Índices de mercado e índices econômicos

Esta documentação trata de índices de mercado da B3.

Indicadores como IPCA, Selic, CDI, IGP-M, câmbio e atividade econômica pertencem ao conjunto de dados macroeconômicos da Partnr. Embora todos possam ser chamados genericamente de índices financeiros ou econômicos, eles possuem fontes, frequências e aplicações diferentes.

Utilize o módulo de Índices para rankings de ativos da bolsa e o módulo macroeconômico para séries de inflação, juros, moedas e atividade econômica.

O que você pode construir?

Termômetro diário do mercado

Mostre em uma plataforma quais ações lideram as altas e as quedas do Ibovespa durante o pregão.

Rankings de fundos imobiliários

Utilize o IFIX para criar listas atualizadas dos fundos imobiliários com melhor e pior desempenho no dia.

Relatórios automáticos

Inclua os destaques positivos e negativos de cada índice em relatórios diários, newsletters ou materiais de acompanhamento.

Alertas e monitoramento

Detecte quando um ativo passa a ocupar as primeiras posições entre as maiores altas ou baixas de seu índice.

Dashboards e aplicativos financeiros

Apresente rankings por índice sem precisar consultar e ordenar individualmente todos os componentes.

Agentes de inteligência artificial

Permita que agentes consultem perguntas como “quais são as maiores altas do Ibovespa?” usando dados estruturados e atualizados.

Boas práticas de integração

• Utilize o parâmetro limit para retornar apenas a quantidade necessária de ativos.
• Verifique o campo updated_at antes de exibir ou armazenar o ranking.
• Converta a variação decimal para percentual na camada de apresentação.
• Trate respostas 404 quando o símbolo do índice não existir ou não possuir dados.
• Mantenha a API key somente no backend ou em um gerenciador de segredos.
• Evite apresentar os dados como tempo real, já que as cotações possuem 15 minutos de atraso.
• Armazene o símbolo do índice separadamente do ticker dos ativos retornados.