BRbrapi-dev
Opções

Vencimentos de opções

Changed on

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.

Passe includeExpired=true para incluir vencimentos passados.

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

get/api/v2/options/expirations

Request

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

Query parameters

underlyingstring required

Ticker do ativo subjacente: ação, ETF, índice, DOL ou WDO.

Example:PETR4
includeExpired'true' | 'false'

true inclui vencimentos passados. Padrão: false, só vencimentos futuros.

Response

Vencimentos retornados com sucesso.

underlyingstring required

Ativo subjacente consultado, em maiúsculas.

tradedOnlytrue required

Sempre true: a lista vem das séries negociadas.

expirationsstring[] required

Datas de vencimento em ordem crescente, no formato YYYY-MM-DD.

requestedAtstring date-time required

Data e hora da requisição em ISO 8601.

tookinteger required

Tempo de processamento, em milissegundos.

Example response

{
  "underlying": "PETR4",
  "tradedOnly": true,
  "expirations": [
    "2026-12-04",
    "2026-12-11",
    "2026-12-18"
  ],
  "requestedAt": "2026-06-02T12:00:00.000Z",
  "took": 4
}

Changes