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

# Listar vencimentos de opções

`GET /api/v2/options/expirations`

Retorna os vencimentos disponíveis para um ativo subjacente. Sem token, o sandbox aceita apenas `underlying=PETR4`.

## Query parameters

- `underlying` string, required — Código do ativo subjacente (ação, ETF ou índice) das opções que você quer listar.
- `includeExpired` 'true' | 'false' — Se `true`, inclui vencimentos já passados. Padrão `false` retorna apenas vencimentos futuros.

## Response `200`

Vencimentos retornados com sucesso.

- OptionExpirationsResponse
  - `underlying` string, required — Ativo subjacente consultado, normalizado em maiúsculas.
  - `tradedOnly` true, required — Sempre `true`: a lista é montada a partir das séries negociadas.
  - `expirations` string[], required — Datas de vencimento disponíveis, em ordem ascendente, no formato YYYY-MM-DD.
  - `requestedAt` string, date-time, required — Data e hora da requisição em formato ISO 8601
  - `took` integer, required — Tempo de processamento em milissegundos

## Other responses

- `400` — Requisição inválida
- `401` — Não autorizado
- `403` — Acesso negado
- `500` — Erro interno do servidor

---

[API](https://skmtc.net/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro.md) · [All operations](https://skmtc.net/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/brapi-dev/brapi-api-do-mercado-financeiro-brasileiro/revisions/f275d46193ea/schema)