---
title: "Histórico v2 de ações"
method: GET
path: "/api/v2/stocks/historical"
tags: ["Ações"]
---

# Histórico v2 de ações

`GET /api/v2/stocks/historical`

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}`.

## Query parameters

- `symbols` string, required — Tickers separados por vírgula. Ex.: PETR4,VALE3. Tickers antigos são resolvidos para o ticker atual quando houver renome conhecido.
- `range` '1d' | '2d' | '5d' | '7d' | '1mo' | '3mo' | '6mo' | '1y' | '2y' | '5y' | '10y' | 'ytd' | 'max' — Janela histórica. Padrão: 1mo.
- `interval` '1m' | '2m' | '5m' | '15m' | '30m' | '60m' | '90m' | '1h' | '1d' | '5d' | '1wk' | '1mo' | '3mo' — Granularidade da série. Padrão: 1d.
- `startDate` string — Data inicial em YYYY-MM-DD.
- `endDate` string — Data final em YYYY-MM-DD.
- `sortOrder` 'asc' | 'desc' — Ordenação dos pontos históricos por data.

## Response `200`

Histórico recuperado com sucesso.

- StockHistoricalResponse
  - `results` StockHistoricalResult[], required
    - `requestedSymbol` string, required — Ticker informado na requisição.
    - `symbol` string, required — Ticker retornado pela brapi após normalização/renome.
    - `changed` boolean, required — `true` quando o ticker informado foi resolvido para outro ticker.
    - `data` StockHistoricalSeries, required
      - `usedInterval` string, required
      - `usedRange` string, required
      - `historicalDataPrice` StockHistoricalPrice[], required
        - `date` integer, required — Data do pregão em Unix timestamp (segundos).
        - `open` number, nullable, required
        - `high` number, nullable, required
        - `low` number, nullable, required
        - `close` number, nullable, required
        - `volume` number, nullable, required
        - `adjustedClose` number, nullable, required
  - `requestedAt` string, date-time, required — Data e hora da requisição em formato ISO 8601
  - `took` integer, required — Tempo de processamento em milissegundos

## Other responses

- `400` — Requisição inválida
- `401` — Não autorizado
- `403` — Acesso negado
- `404` — Não encontrado
- `429` — Limite de requisições excedido
- `500` — Erro interno do servidor

---

[API](https://skmtc.net/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro.md) · [All operations](https://skmtc.net/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/brapi-dev/brapi-api-do-mercado-financeiro-brasileiro/versions/f275d46193ea/schema)