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

# Histórico da opção

`GET /api/v2/futures/options/historical`

Série diária de uma opção sobre futuro, com OHLC e volume.

## Query parameters

- `symbol` string, required — Código da opção (ex.: `BGIM26C028000`).
- `startDate` string — Data inicial (YYYY-MM-DD). Padrão: 12 meses atrás.
- `endDate` string — Data final (YYYY-MM-DD). Padrão: hoje.
- `sortOrder` 'asc' | 'desc'

## Response `200`

Histórico.

- FutureOptionHistoricalResponse
  - `option` FutureOptionWithHistory, required
    - `symbol` string, required — Código da opção (ex.: `BGIH27C028550`).
    - `underlyingAsset` string, required — Código do ativo (ex.: `BGI`).
    - `underlyingFuture` string, nullable, required — Contrato futuro de base, quando existir.
    - `optionType` 'call' | 'put', required — `call` (compra) ou `put` (venda).
    - `optionStyle` 'american' | 'european', nullable, required — `american` (exerce a qualquer momento) ou `european` (só no vencimento).
    - `segment` 'financial' | 'agribusiness', required — `financial` ou `agribusiness`.
    - `strike` number, required — Strike (preço combinado).
    - `expirationDate` string, required — Data de vencimento (YYYY-MM-DD).
    - `firstTradeDate` string, nullable, required — Data do primeiro pregão.
    - `lastTradeDate` string, nullable, required — Data do último pregão.
    - `contractMultiplier` number, nullable, required — Multiplicador (vem do futuro de base).
    - `allocationRoundLot` integer, nullable, required — Tamanho do lote.
    - `exerciseType` string, nullable, required — Tipo de exercício.
    - `automaticExercise` boolean, nullable, required — `true` se a opção é exercida sozinha no vencimento.
    - `premiumUpfront` boolean, nullable, required — `true` se o prêmio é pago à vista, `false` se é diferido.
    - `isin` string, nullable, required — Código ISIN.
    - `cficCode` string, nullable, required — Código CFI.
    - `history` FutureOptionPricePoint[], required
      - `date` integer, required — Data do pregão (Unix em segundos).
      - `open` number, nullable, required — Abertura.
      - `high` number, nullable, required — Máxima.
      - `low` number, nullable, required — Mínima.
      - `average` number, nullable, required — Preço médio.
      - `close` number, nullable, required — Fechamento.
      - `referencePrice` number, nullable, required — Preço de referência oficial.
      - `oscillationPct` number, nullable, required — Variação % em relação ao dia anterior.
      - `trades` number, nullable, required — Número de negócios.
      - `volume` number, nullable, required — Quantidade de contratos negociados.
      - `financialVolume` number, nullable, required — Volume em reais (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/versions/f275d46193ea/schema)