Cotações

O módulo de Cotações reúne endpoints de mercado para cotações com 15 minutos de atraso, séries históricas (OHLCV), dados prontos para gráficos e variações do último pregão. Ideal para construir gráficos, dashboards, carteiras, alertas, backtests e telas de consulta rápida.

O que você encontra aqui

• Cotações (GET /quotes/:ticker): cotação atual, série histórica (diária/intraday) ou presets de gráfico para um único ticker.
• Cotações em lote (POST /quotes): mesmo poder, mas para até 500 tickers em uma única chamada.
• Variações (D-1) (GET /stocks/variations): maiores altas e baixas do último pregão.

Cobertura

Ações, fundos listados, BDRs, ETFs e índices (IBOV, SMLL, IFIX).

Atraso e acesso por plano

As cotações são fornecidas com 15 minutos de atraso em relação ao pregão. Os modos de consulta (type, interval, start_date, end_date) estão disponíveis apenas para planos com acesso a cotações com 15 minutos de atraso.

Planos sem esse acesso recebem apenas cotações do dia anterior (D-1) — o único parâmetro aceito é adjusted.

Modos de consulta

type	O que retorna	Uso típico
current	Cotação spot (último preço)	Telas em tempo real, alertas
historical	Série diária ou intraday	Gráficos, backtests, análises
chart	Presets prontos (1d, 5d, 1M, 6M, 1Y, 5Y)	UI com seletores de período

Ajuste de preços

• Padrão: preços não ajustados (como negociados no pregão).
• Com adjusted=true: preços ajustados por eventos corporativos (desdobramentos, grupamentos, proventos). Datapoints incluem adjustment_factor.

Como escolher o endpoint

1. Precisa de cotação/gráfico de um ticker → Cotações
2. Precisa de cotações de vários tickers de uma vez → Cotações em lote
3. Quer um "market snapshot" do dia (maiores altas e baixas) → Variações (D-1)