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

# Vencimentos de opções sobre futuros

`GET /api/v2/futures/options/expirations`

## Request

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

Retorna as datas de vencimento de opções sobre um contrato futuro, como boi gordo (`BGI`), café arábica (`ICF`), milho (`CCM`) e soja (`SJC`). Por padrão, só vencimentos futuros.

Use para montar um seletor de vencimento, listar vencimentos passados em um backtest e escolher a data antes de consultar a [cadeia de opções sobre futuros](https://brapi.dev/docs/futuros/opcoes/series).

Passe `includeExpired=true` para incluir vencimentos passados. O vencimento da opção pode ser diferente do vencimento do futuro. Não calcule uma data a partir da outra.

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

## Query parameters

- `underlying` string, required: Código do ativo do futuro. Ex.: `BGI`, `ICF`.
- `includeExpired` 'true' | 'false': `true` inclui vencimentos passados. Padrão: `false`, só vencimentos futuros.

## Response `200`

Vencimentos retornados com sucesso.

- FutureOptionExpirationsResponse
  - `underlying` string, required
  - `expirations` string[], required
  - `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.
- `500`: Erro interno do servidor.

## Changes

- **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/expirations/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)