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

# Vencimentos de opções

`GET /api/v2/options/expirations`

## Request

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

Retorna as datas de vencimento de opções de um ativo subjacente: ação, ETF, índice, `DOL` ou `WDO`. 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](https://brapi.dev/docs/opcoes/series).

Passe `includeExpired=true` para incluir vencimentos passados.

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

## Query parameters

- `underlying` string, required: Ticker do ativo subjacente: ação, ETF, índice, `DOL` ou `WDO`.
- `includeExpired` 'true' | 'false': `true` inclui vencimentos passados. Padrão: `false`, só vencimentos futuros.

## Response `200`

Vencimentos retornados com sucesso.

- OptionExpirationsResponse
  - `underlying` string, required: Ativo subjacente consultado, em maiúsculas.
  - `tradedOnly` true, required: Sempre `true`: a lista vem das séries negociadas.
  - `expirations` string[], required: Datas de vencimento em ordem crescente, no formato YYYY-MM-DD.
  - `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-04-26** `3ae1b2752c0b`: 1 info
  - endpoint added

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