v20

latestOpenAPI 3.1.0MITraw.githubusercontent.com2026-07-2176162684.2 KB

Opções

Listar vencimentos de opções

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

get/api/v2/options/expirations

Query parameters

underlyingstring required

Código do ativo subjacente (ação, ETF ou índice) das opções que você quer listar.

Example:PETR4

includeExpired'true' | 'false'

Se true, inclui vencimentos já passados. Padrão false retorna apenas vencimentos futuros.

Response

Vencimentos retornados com sucesso.

underlyingstring required

Ativo subjacente consultado, normalizado em maiúsculas.

tradedOnlytrue required

Sempre true: a lista é montada a partir das séries negociadas.

expirationsstring[] required

Datas de vencimento disponíveis, em ordem ascendente, no formato YYYY-MM-DD.

requestedAtstring date-time required

Data e hora da requisição em formato 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
}