# Histórico de Opções sobre Futuros
URL: /docs/futuros/opcoes/historico.mdx

Série diária de uma opção sobre futuro: OHLC, preço de referência e volume. Pronto para gráfico ou backtest.

***

title: Histórico de Opções sobre Futuros
description: >-
Série diária de uma opção sobre futuro: OHLC, preço de referência e
volume. Pronto para gráfico ou backtest.
full: true
keywords: brapi, api, opções sobre futuros, histórico, OHLC, backtest
openGraph:
title: Histórico de Opções sobre Futuros
description: >-
Série diária de uma opção sobre futuro.
type: website
locale: pt\_BR
lastUpdated: '2026-05-21T12:00:00.000Z'
lang: pt-BR
\_openapi:
method: GET
route: /api/v2/futures/options/historical
structuredData:
headings: \[]
contents:

* content: >-
  Série diária de uma opção sobre futuro identificada por símbolo,
  pronta para gráfico ou backtest.

***

import { Callout } from 'fumadocs-ui/components/callout';

Retorna a série diária de uma opção sobre futuro, pelo `symbol`
(ex.: `BGIK26C034300`).

O normal é descobrir a série em
[Cadeia](/docs/futuros/opcoes/series) e depois chamar este endpoint. Ele
aceita **uma série por vez**.

A resposta tem:

* **Dados completos do contrato** — strike, optionStyle, multiplier, lote,
  ISIN etc.
* **Série diária com negócio** — OHLC, referencePrice, oscillationPct,
  trades, volume, financialVolume.

<Callout type="info">
  A maioria das séries longe do preço atual negocia pouco — sua resposta
  pode ter só alguns dias. Para acompanhar todo dia, escolha a série mais
  próxima do preço atual.
</Callout>

<Callout type="info">
  **Plano Pro.** Sem token, aceita só `symbol` começando com `BGI`.
</Callout>





## Swagger Documentation

# brapi - API do Mercado Financeiro Brasileiro - /api/v2/futures/options/historical

Single endpoint documentation for /api/v2/futures/options/historical

## Base URLs

- `https://brapi.dev` - Servidor principal da API brapi
- `http://localhost:3001` - Servidor local para desenvolvimento

## GET /api/v2/futures/options/historical

**Summary:** Histórico da opção

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

**Tags:** Opções sobre Futuros

### Parameters

- **symbol** (query) *required*
- **startDate** (query)
- **endDate** (query)
- **sortOrder** (query)

### Responses

#### 200

Histórico.

#### 400

Requisição inválida

#### 401

Não autorizado

#### 403

Acesso negado

#### 404

Não encontrado

#### 500

Erro interno do servidor

## Schemas

The following schemas are used by this endpoint:

### ErrorResponse

Erro interno do servidor

**Properties:**

- **error** (boolean) - Options: `true` *(required)*

- **message** (string) *(required)*

- **code** (string)


### FutureOptionHistoricalResponse

**Properties:**

- **option** *(required)*
  Reference to: **FutureOptionWithHistory**

- **requestedAt** (string, date-time) *(required)*
  Data e hora da requisição em formato ISO 8601

- **took** (integer) *(required)*
  Tempo de processamento em milissegundos


### FutureOptionPricePoint

**Properties:**

- **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).


### FutureOptionSpecs

**Properties:**

- **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** (string) - Options: `call`, `put` *(required)*
  `call` (compra) ou `put` (venda).

- **optionStyle** (string) - Options: `american`, `european` *(nullable)* *(required)*
  `american` (exerce a qualquer momento) ou `european` (só no vencimento).

- **segment** (string) - Options: `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.


### FutureOptionWithHistory