# Cadeia de Opções sobre Futuros
URL: /docs/futuros/opcoes/series.mdx

Cadeia (calls + puts) de opções sobre um futuro num vencimento, com preço, volume, estilo e multiplicador.

***

title: Cadeia de Opções sobre Futuros
description: >-
Cadeia (calls + puts) de opções sobre um futuro num vencimento, com
preço, volume, estilo e multiplicador.
full: true
keywords: brapi, api, opções sobre futuros, cadeia, chain, calls, puts, série
openGraph:
title: Cadeia de Opções sobre Futuros
description: >-
Cadeia (calls + puts) de opções sobre um futuro num vencimento.
type: website
locale: pt\_BR
lastUpdated: '2026-05-21T12:00:00.000Z'
lang: pt-BR
\_openapi:
method: GET
route: /api/v2/futures/options/chain
structuredData:
headings: \[]
contents:

* content: >-
  Cadeia (calls e puts) de opções sobre um futuro num vencimento,
  com o último preço.

***

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

Retorna todas as séries (calls e puts) do vencimento, com o último preço
até a data pedida.

Cada série tem:

* **Dados do contrato:** `symbol`, `optionType` (call/put), `optionStyle`
  (american/european), `strike`, `expirationDate`, `contractMultiplier`,
  `allocationRoundLot`, `automaticExercise`.
* **Cotação do dia:** OHLC, `referencePrice`, `oscillationPct`, `trades`,
  `volume`, `financialVolume`.

Filtros opcionais: `side=call|put`, `minStrike`, `maxStrike`.

<Callout type="info">
  A maioria das séries longe do preço atual tem pouca negociação. `close`
  pode vir `null` em muitas linhas — o `referencePrice` pode estar
  preenchido mesmo sem negócio.
</Callout>

<Callout type="info">
  **Plano Pro.** Sem token, aceita só `underlying=BGI`.
</Callout>





## Swagger Documentation

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

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

## Base URLs

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

## GET /api/v2/futures/options/chain

**Summary:** Cadeia (calls + puts)

Cadeia completa de calls e puts de um vencimento, com o último preço de cada série.

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

### Parameters

- **underlying** (query) *required*
- **expirationDate** (query) *required*
- **date** (query)
- **side** (query)
- **minStrike** (query)
- **maxStrike** (query)

### Responses

#### 200

Cadeia.

#### 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)


### FutureOptionChainResponse

**Properties:**

- **underlying** (string) *(required)*

- **expirationDate** (string) *(required)*

- **date** (string) *(required)*

- **series** (array) *(required)*
  Array items:
    Reference to: **FutureOptionQuote**

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

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


### FutureOptionQuote

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

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