---
title: "Histórico de opção"
method: GET
path: "/api/v2/options/historical"
tags: ["Opções"]
---

# Histórico de opção

`GET /api/v2/options/historical`

## Request

- Base URL: `https://brapi.dev`
- URL: `https://brapi.dev/api/v2/options/historical`
- Auth: HTTP bearer

Retorna o histórico diário de uma série de opção, identificada por `symbol` e `expirationDate`: OHLC, bid, ask, negócios e volume por pregão.

Use para montar gráficos de prêmio, fazer backtests e analisar a liquidez de uma série.

Se o mesmo `symbol` aparece duas vezes no vencimento, passe também `strike`. Encontre a série na [cadeia de opções](https://brapi.dev/docs/opcoes/series).

Séries fora do dinheiro passam dias sem negócio. Um pregão sem negócio não aparece no histórico.

Disponível no plano Pro. Sem token, aceita só `symbol` com prefixo `PETR`.

## Query parameters

- `symbol` string, required: Código da série de opção.
- `expirationDate` string, required: Data de vencimento da série, no formato YYYY-MM-DD.
- `strike` number, nullable: Preço de exercício. Use quando o mesmo `symbol` aparece mais de uma vez no vencimento.
- `startDate` string: Data inicial, no formato YYYY-MM-DD. Padrão: 12 meses atrás.
- `endDate` string: Data final, no formato YYYY-MM-DD. Padrão: hoje.
- `sortOrder` 'asc' | 'desc': Ordem por data: `asc` do mais antigo ao mais recente, `desc` do mais recente ao mais antigo.

## Response `200`

Histórico retornado com sucesso.

- OptionHistoricalResponse
  - `option` OptionSeriesWithHistory, required: Dados da série e `history`, com um ponto por pregão no intervalo pedido.
    - `symbol` string, required: Código da série de opção. Ex.: PETRF783.
    - `underlyingSymbol` string, nullable, required: Ativo subjacente da opção. Ex.: PETR4.
    - `side` 'call' | 'put', required: `call` (opção de compra) ou `put` (opção de venda).
    - `market` 'equity' | 'index' | 'currency', required: Mercado da opção: `equity` para ação ou ETF, `index` para índice, `currency` para DOL e WDO.
    - `optionStyle` 'american' | 'european', nullable, required: `american` permite exercício até o vencimento. `european` permite exercício só no vencimento. Nulo quando o cadastro da série não informa o estilo.
    - `strike` number, nullable, required: Preço de exercício da opção.
    - `allocationRoundLot` integer, nullable, required: Lote padrão de negociação. Em geral, 100 nas opções sobre ações.
    - `expirationDate` string, required: Data de vencimento, no formato YYYY-MM-DD.
    - `firstTradeDate` string, required: Data do primeiro pregão da série, no formato YYYY-MM-DD.
    - `lastTradeDate` string, required: Data do último pregão da série, no formato YYYY-MM-DD.
    - `history` OptionPricePoint[], required: Um ponto por pregão no intervalo pedido.
      - `date` integer, required: Data do pregão, em timestamp Unix (segundos).
      - `open` number, nullable, required: Preço de abertura.
      - `high` number, nullable, required: Preço máximo.
      - `low` number, nullable, required: Preço mínimo.
      - `average` number, nullable, required: Preço médio.
      - `close` number, nullable, required: Preço de fechamento.
      - `referencePrice` number, nullable, required: Preço de referência do pregão.
      - `bid` number, nullable, required: Melhor oferta de compra no fechamento.
      - `ask` number, nullable, required: Melhor oferta de venda no fechamento.
      - `trades` number, nullable, required: Número de negócios.
      - `volume` number, nullable, required: Número de contratos negociados.
      - `financialVolume` number, nullable, required: Volume financeiro, em reais.
  - `requestedAt` string, date-time, required: Data e hora da requisição em ISO 8601.
  - `took` integer, required: Tempo de processamento, em milissegundos.

## Other responses

- `400`: Requisição inválida. Confira os parâmetros.
- `401`: Token ausente ou inválido.
- `403`: O plano não inclui este recurso ou parâmetro.
- `404`: Nenhum dado encontrado para o pedido.
- `500`: Erro interno do servidor.

## Changes

- **2026-08-25** `297945b14cad`: 1 warning, 1 info
  - added the new `currency` enum value to the `option/allOf[#/components/schemas/OptionSeries]/market` response property for the response status `200`
  - added the required property `option/allOf[subschema #2]/history/items/referencePrice` to the response with the `200` status
- **2026-05-22** `c9743d203cb0`: 2 info
  - added the required property `option/allOf[#/components/schemas/OptionSeries]/allocationRoundLot` to the response with the `200` status
  - added the required property `option/allOf[#/components/schemas/OptionSeries]/optionStyle` to the response with the `200` status
- **2026-04-26** `3ae1b2752c0b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/changes/api/v2/options/historical/get.md)

---

[API](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro.md) - [All operations](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/llms.txt) - [OpenAPI document](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/revisions/7c732d79148a?raw)