---
title: "Obter histórico diário de uma série de opção"
method: GET
path: "/api/v2/options/historical"
tags: ["Opções"]
---

# Obter histórico diário de uma série de opção

`GET /api/v2/options/historical`

Retorna o histórico diário EOD de uma única série, identificada por `symbol` e `expirationDate`. Sem token, o sandbox aceita apenas símbolos com prefixo `PETR` (opções de PETR4).

## Query parameters

- `symbol` string, required — Símbolo da opção
- `expirationDate` string, required — Data de vencimento no formato YYYY-MM-DD
- `strike` number, nullable — Preço de exercício. Use quando o mesmo símbolo aparecer mais de uma vez no mesmo vencimento.
- `startDate` string — Data de início no formato YYYY-MM-DD (padrão: 12 meses)
- `endDate` string — Data de fim no formato YYYY-MM-DD
- `sortOrder` 'asc' | 'desc' — Ordem dos pontos em `history` por data: `asc` do mais antigo ao mais recente, `desc` do mais recente ao mais antigo. Padrão `desc`.

## Response `200`

Histórico retornado com sucesso.

- OptionHistoricalResponse
  - `option` OptionSeriesWithHistory, required — Metadados da série consultada acompanhados de `history`, com um ponto OHLCV por pregão no intervalo pedido.
    - `symbol` string, required — Código de negociação da série (ex: PETRF783).
    - `underlyingSymbol` string, nullable, required — Ativo subjacente da opção (ex: PETR4).
    - `side` 'call' | 'put', required — Tipo da opção: `call` (opção de compra) ou `put` (opção de venda).
    - `market` 'equity' | 'index', required — Mercado da opção: `equity` (ação/ETF) ou `index` (índice).
    - `optionStyle` 'american' | 'european', nullable, required — Estilo de exercício da opção: `american` permite exercício a qualquer momento até o vencimento; `european` permite exercício apenas no vencimento. `null` em séries antigas que ainda não passaram pelo enriquecimento de cadastro.
    - `strike` number, nullable, required — Preço de exercício (strike) da opção.
    - `allocationRoundLot` integer, nullable, required — Tamanho do lote pré-definido para alocação. Geralmente 100 para opções sobre ações brasileiras.
    - `expirationDate` string, required — Data de vencimento da série, no formato YYYY-MM-DD.
    - `firstTradeDate` string, required — Data do primeiro pregão observado para a série (YYYY-MM-DD).
    - `lastTradeDate` string, required — Data do último pregão observado para a série (YYYY-MM-DD).
    - `history` OptionPricePoint[], required — Pontos EOD diários da série no intervalo consultado. Cada item traz OHLCV, bid/ask, número de negócios e volume financeiro.
      - `date` integer, required — Data do pregão em timestamp Unix (segundos).
      - `open` number, nullable, required — Preço de abertura do pregão.
      - `high` number, nullable, required — Máxima do pregão.
      - `low` number, nullable, required — Mínima do pregão.
      - `average` number, nullable, required — Preço médio do pregão.
      - `close` number, nullable, required — Preço de fechamento do pregão.
      - `bid` number, nullable, required — Melhor oferta de compra registrada no fechamento.
      - `ask` number, nullable, required — Melhor oferta de venda registrada no fechamento.
      - `trades` number, nullable, required — Número de negócios realizados no pregão.
      - `volume` number, nullable, required — Volume negociado no pregão (em contratos).
      - `financialVolume` number, nullable, required — Volume financeiro negociado no pregão (em BRL).
  - `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
- `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/revisions/f275d46193ea/schema)