Variações (D-1)

GET

/stocks/variations

Retorna as variações do último pregão (D-1) para todas as ações, incluindo maiores altas e maiores baixas.

Atualizado diariamente (frequência diária).

Quando usar

• Criar um “market snapshot” do dia (top altas/baixas)
• Montar listas de destaque em portais e dashboards
• Disparar alertas e automações com base em variação diária

Parâmetros de requisição

Parâmetro	Local	Descrição	Obrigatório
adjusted	Query	Boolean. Calcula variação usando cotações ajustadas por eventos corporativos e proventos. Padrão: false.	Opcional

Ajustado vs não ajustado

• adjusted=false (padrão): variação calculada com base em preços não ajustados.
• adjusted=true: variação calculada com base em preços ajustados, útil para comparações históricas mais consistentes (principalmente em períodos com proventos/eventos).

Sobre discrepâncias sem ajuste

Quando adjusted=false, a variação pode parecer discrepante em dias próximos a eventos corporativos (ex.: proventos, grupamentos/desdobramentos e outros ajustes que alteram a base de preço).
Se você precisa de comparações mais consistentes, especialmente para rankings e análises históricas, use adjusted=true.

Resposta

Código	Descrição
200	Retorna altas e baixas.
401	Não autorizado.

Formato da resposta

A resposta é um objeto com os campos abaixo:

Campo	Tipo	Descrição
highs	array	Lista das maiores altas do último pregão.
lows	array	Lista das maiores baixas do último pregão.

Estrutura de highs[] e lows[]

Campo	Tipo	Descrição
ticker	string	Ticker do ativo.
date	string (ISO 8601)	Data de referência da variação.
price	number	Preço usado como referência no cálculo da variação.
variation	number	Variação percentual (ex.: 0.1402 = +14,02%).
variation_value	number	Variação em valor absoluto (diferença em BRL).
currency	string	Moeda dos valores retornados (ex.: BRL).
company	object	Informações básicas da empresa associada ao ticker.

Estrutura de company

Campo	Tipo	Descrição
company_id	string	CNPJ/identificador da empresa.
name	string	Razão social da empresa.
trading_name	string	Nome de negociação da empresa.

Exemplo

{
  "highs": [
    {
      "ticker": "BALM4",
      "date": "2025-09-30T22:00:00.000Z",
      "price": 20.5,
      "variation": 0.1402,
      "variation_value": 2.52,
      "currency": "BRL",
      "company": {
        "company_id": "61374161000130",
        "name": "BAUMER S.A.",
        "trading_name": "BAUMER"
      }
    }
  ],
  "lows": [
    {
      "ticker": "AMBP3",
      "date": "2025-09-30T22:00:00.000Z",
      "price": 8.52,
      "variation": -0.1917,
      "variation_value": -2.02,
      "currency": "BRL",
      "company": {
        "company_id": "12648266000124",
        "name": "AMBIPAR PARTICIPACOES E EMPREENDIMENTOS S/A",
        "trading_name": "AMBIPAR"
      }
    }
  ]
}

:::info[Observações]
	-	variation é a variação percentual (ex.: 0.1402 = +14,02%).
	-	variation_value é a variação em valor (diferença em BRL).
	-	price representa o preço de referência do último pregão para o cálculo da variação retornada.
:::