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

Liste os vencimentos disponíveis de opções por ativo subjacente, de um jeito simples para descobrir qual série consultar depois.

***

title: Vencimentos de Opções
description: >-
Liste os vencimentos disponíveis de opções por ativo subjacente, de um jeito
simples para descobrir qual série consultar depois.
full: true
keywords: brapi, api, opções, vencimentos
openGraph:
title: Vencimentos de Opções
description: >-
Liste os vencimentos disponíveis de opções por ativo subjacente.
type: website
locale: pt\_BR
lastUpdated: '2026-04-22T12:00:00.000Z'
lang: pt-BR
\_openapi:
method: GET
route: /api/v2/options/expirations
structuredData:
headings: \[]
contents:

* content: >-
  Retorna os vencimentos de opções disponíveis para um ativo
  subjacente, como `PETR4`. Use como primeiro passo antes de consultar
  strikes ou séries negociadas.

***

import { Callout } from 'fumadocs-ui/components/callout';

Retorna os vencimentos de opções disponíveis para um ativo subjacente (ação,
ETF ou índice). Por padrão, mostra apenas vencimentos futuros — envie
`includeExpired=true` para incluir vencimentos passados.

Use este endpoint como ponto de partida quando você ainda não sabe qual
vencimento consultar. Veja o fluxo completo em
[Opções](/docs/opcoes).

<Callout type="info">
  **Plano mínimo: Pro.** No sandbox sem token, aceita apenas `underlying=PETR4`.
</Callout>





## 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:** Listar vencimentos de opções

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

**Tags:** Opções

### Parameters

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

### Responses

#### 200

Vencimentos retornados com sucesso.

#### 400

Requisição inválida

#### 401

Não autorizado

#### 403

Acesso negado

#### 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, normalizado em maiúsculas.

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

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


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

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