# Vencimentos de opções
URL: /docs/opcoes/vencimentos.mdx

Datas de vencimento de opções sobre ações, ETFs, índices, DOL e WDO, com opção de incluir vencimentos passados.





## Swagger Documentation

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

Single endpoint documentation for /api/v2/options/expirations

## Base URLs

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

## GET /api/v2/options/expirations

**Summary:** Vencimentos de opções


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


**Tags:** Opções

### Parameters

- **underlying** (query) *required*
- **includeExpired** (query)

### Responses

#### 200

Vencimentos retornados com sucesso.

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

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


### OptionExpirationsResponse

**Properties:**

- **underlying** (string) *(required)*
  Ativo subjacente consultado, em maiúsculas.

- **tradedOnly** (boolean) - Options: `true` *(required)*
  Sempre `true`: a lista vem das séries negociadas.

- **expirations** (array) *(required)*
  Datas de vencimento em ordem crescente, no formato YYYY-MM-DD.
  Array items:
    **Type:** string


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

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