BRbrapi-dev
Opções sobre Futuros

Vencimentos de opções sobre futuros

Changed on

Retorna as datas de vencimento de opções sobre um contrato futuro, como boi gordo (BGI), café arábica (ICF), milho (CCM) e soja (SJC). 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 sobre futuros.

Passe includeExpired=true para incluir vencimentos passados. O vencimento da opção pode ser diferente do vencimento do futuro. Não calcule uma data a partir da outra.

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

get/api/v2/futures/options/expirations

Request

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

Query parameters

underlyingstring required

Código do ativo do futuro. Ex.: BGI, ICF.

Example:BGI
includeExpired'true' | 'false'

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

Response

Vencimentos retornados com sucesso.

underlyingstring required
expirationsstring[] required
requestedAtstring date-time required

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

tookinteger required

Tempo de processamento, em milissegundos.

Example response

{
  "underlying": "BGI",
  "expirations": [
    "2026-07-31",
    "2027-08-31",
    "2026-09-30",
    "2026-10-30",
    "2026-11-30",
    "2026-12-30",
    "2027-03-31"
  ],
  "requestedAt": "2026-06-02T12:00:00.000Z",
  "took": 22
}

Changes