---
title: "Cadeia de opções sobre futuros"
method: GET
path: "/api/v2/futures/options/chain"
tags: ["Opções sobre Futuros"]
---

# Cadeia de opções sobre futuros

`GET /api/v2/futures/options/chain`

## Request

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

Retorna as calls e puts de um vencimento de opções sobre futuro, com dados do contrato (`symbol`, `optionType`, `optionStyle`, `strike`, `contractMultiplier`) e a cotação do pregão: OHLC, `referencePrice`, volume e contratos em aberto.

Use para montar uma tela de opções por vencimento, comparar calls e puts por strike e filtrar séries por faixa de strike.

Todas as séries vêm do mesmo pregão: o último com dados até a data pedida, informado em `date`. Séries sem registro nesse pregão não aparecem.

Muitas séries não negociam todo dia. Sem negócio, `close` vem `null` e `referencePrice` costuma vir preenchido.

Disponível no plano Pro. Sem token, aceita só `underlying=BGI`.

## Query parameters

- `underlying` string, required: Código do ativo do futuro. Ex.: `BGI`.
- `expirationDate` string, required: Data de vencimento, no formato YYYY-MM-DD. Veja os vencimentos em `/expirations`.
- `date` string: Data do pregão, no formato YYYY-MM-DD. Padrão: último pregão disponível.
- `side` 'call' | 'put': Filtra por `call` ou `put`. Sem o filtro, retorna os dois.
- `minStrike` number, nullable: Strike mínimo.
- `maxStrike` number, nullable: Strike máximo.

## Response `200`

Séries retornadas com sucesso.

- FutureOptionChainResponse
  - `underlying` string, required
  - `expirationDate` string, required
  - `date` string, required
  - `series` FutureOptionQuote[], required
    - `symbol` string, required: Código da série de opção. Ex.: `BGIH27C028550`.
    - `underlyingAsset` string, required: Código do ativo do futuro. Ex.: `BGI`.
    - `underlyingFuture` string, nullable, required: Contrato futuro de base, quando informado.
    - `optionType` 'call' | 'put', required: `call` (opção de compra) ou `put` (opção de venda).
    - `optionStyle` 'american' | 'european', nullable, required: `american` permite exercício até o vencimento. `european` permite exercício só no vencimento.
    - `segment` 'financial' | 'agribusiness', required: Segmento do contrato: `financial` ou `agribusiness`.
    - `strike` number, required: Preço de exercício da opção, na unidade de cotação do futuro.
    - `expirationDate` string, required: Data de vencimento, no formato YYYY-MM-DD.
    - `firstTradeDate` string, nullable, required: Data do primeiro pregão da série, no formato YYYY-MM-DD.
    - `lastTradeDate` string, nullable, required: Data do último pregão da série, no formato YYYY-MM-DD.
    - `contractMultiplier` number, nullable, required: Multiplicador do contrato, herdado do futuro. Ex.: 330 arrobas no boi gordo.
    - `allocationRoundLot` integer, nullable, required: Lote padrão de negociação.
    - `exerciseType` string, nullable, required: Tipo de exercício.
    - `automaticExercise` boolean, nullable, required: `true` quando a opção é exercida automaticamente no vencimento.
    - `premiumUpfront` boolean, nullable, required: `true` se o prêmio é pago à vista, `false` se é diferido.
    - `isin` string, nullable, required: Código ISIN da série de opção.
    - `cficCode` string, nullable, required: Código CFI.
    - `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. Costuma vir preenchido mesmo sem negócio.
    - `oscillationPct` number, nullable, required: Variação percentual em relação ao pregão anterior.
    - `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.
    - `openInterest` number, nullable, required: Contratos em aberto na série, na última apuração até a data pedida.
    - `openInterestChange` number, nullable, required: Variação de contratos em aberto desde a apuração anterior.
    - `openInterestDate` string, nullable, required: Data da apuração usada, no formato YYYY-MM-DD. Pode ser anterior à data do pregão.
  - `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-29** `40fae0b2d5fb`: 3 info
  - added the required property `series/items/openInterest` to the response with the `200` status
  - added the required property `series/items/openInterestChange` to the response with the `200` status
  - added the required property `series/items/openInterestDate` to the response with the `200` status
- **2026-05-22** `c9743d203cb0`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/changes/api/v2/futures/options/chain/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)