Ações
Histórico v2 de ações
Retorna séries históricas OHLCV para um ou mais tickers B3.
Use este endpoint quando você precisa apenas de preços históricos. Para snapshot de cotação, use /api/v2/stocks/quote; para descobrir tickers, use /api/v2/tickers.
O endpoint aceita range/interval ou startDate/endDate e respeita os mesmos limites de plano do comportamento histórico legado em /api/quote/{tickers}.
get/api/v2/stocks/historical
Query parameters
symbolsstring required
Tickers separados por vírgula. Ex.: PETR4,VALE3. Tickers antigos são resolvidos para o ticker atual quando houver renome conhecido.
Example:PETR4,VALE3
range'1d' | '2d' | '5d' | '7d' | '1mo' | '3mo' | '6mo' | '1y' | '2y' | '5y' | '10y' | 'ytd' | 'max'
Janela histórica. Padrão: 1mo.
Example:1y
interval'1m' | '2m' | '5m' | '15m' | '30m' | '60m' | '90m' | '1h' | '1d' | '5d' | '1wk' | '1mo' | '3mo'
Granularidade da série. Padrão: 1d.
Example:1d
startDatestring
Data inicial em YYYY-MM-DD.
Example:2024-01-01
endDatestring
Data final em YYYY-MM-DD.
Example:2024-12-31
sortOrder'asc' | 'desc'
Ordenação dos pontos históricos por data.
Example:desc
Response
Histórico recuperado com sucesso.
Example response
{
"results": [
{
"requestedSymbol": "PETR4",
"symbol": "PETR4",
"changed": false,
"data": {
"usedInterval": "1d",
"usedRange": "1mo",
"historicalDataPrice": [
{
"date": 1781233200,
"open": 41.06,
"high": 41.53,
"low": 40.82,
"close": 41.18,
"volume": 34081000,
"adjustedClose": 41.18
}
]
}
}
],
"requestedAt": "2026-06-14T05:03:16.000Z",
"took": 907
}