Preços históricos de ativos

GET

/quotes/[ticker]

Retorna uma lista de cotações do ticker informado em [ticker], com dados de abertura, fechamento, máxima, mínima, volume e outros campos úteis para séries temporais.

As cotações são atualizadas diariamente (frequência diária) e os preços não são ajustados por padrão.

Quando usar

• Construir gráficos de preços e volume (OHLCV)
• Fazer backtests e análises de performance
• Alimentar dashboards e relatórios com séries temporais por ativo

Parâmetros de requisição

Parâmetro	Local	Descrição	Obrigatório
[ticker]	URL	Ticker consultado. Ex.: PETR3	Obrigatório
start_date	Query	Data inicial. Formato: YYYY-MM-DD	Opcional
end_date	Query	Data final. Formato: YYYY-MM-DD	Opcional
adjusted	Query	Boolean. Histórico ajustado por proventos e eventos corporativos.	Opcional

Padrões (quando omitido)

• Se start_date não for informado, o retorno traz um ano (dias corridos).
• Se end_date não for informado, o padrão é a data de hoje.
• Se adjusted não for informado, o padrão é false.

Ajustado vs não ajustado

• adjusted=false (padrão): retorna a série bruta, como negociada no pregão.
• adjusted=true: retorna a série ajustada, apropriada para análises históricas e comparações consistentes ao longo do tempo, não retornando o campo adjustement_factor.

Dica prática: para gráficos de longo prazo e cálculo de retornos, prefira adjusted=true.
Para conferência operacional, adjusted=false costuma ser suficiente.

Resposta

Código	Descrição
200	Retorna as cotações.
400	Parâmetros ausentes ou inválidos.
401	Não autorizado.
404	Sem dados ou ticker não encontrado.

Formato da resposta

A resposta é uma lista de objetos com os campos abaixo:

Campo	Tipo	Descrição
ticker	string	Ticker do ativo consultado.
date	string (ISO 8601)	Data de referência da cotação.
open_price	number	Preço de abertura no pregão.
close_price	number	Preço de fechamento no pregão.
highest_price	number	Maior preço negociado no pregão.
lowest_price	number	Menor preço negociado no pregão.
average_price	number	Preço médio negociado no pregão.
currency	string	Moeda da cotação (ex.: BRL).
volume	number	Volume financeiro negociado no período.
adjustment_factor	number	Fator de ajuste por eventos corporativos (se 1, não há ajuste).

Exemplo

[
  {
    "ticker": "PETR4",
    "date": "2025-02-05T22:00:00.000Z",
    "open_price": 32.16,
    "close_price": 32,
    "highest_price": 32.18,
    "lowest_price": 31.9,
    "average_price": 32.02,
    "currency": "BRL",
    "volume": 757726088,
    "adjustment_factor": 0.8680821961067703
  }
]

:::info[Boas práticas]
	- Use start_date e end_date para limitar payload e acelerar respostas.
	-	Para consultas recorrentes (dashboards), cacheie a última resposta e atualize diariamente.
	-	Se você precisa de pontos em ordem crescente (mais antigo primeiro), reordene no cliente.
:::