Opções
Vencimentos de Opções
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.
Plano mínimo: Pro. No sandbox sem token, aceita apenas underlying=PETR4.
Authorization
Bearer AuthorizationBearer <token>
Token de API obtido no dashboard em brapi.dev/dashboard
In: header
Query Parameters
underlying*string
Código do ativo subjacente (ação, ETF ou índice) das opções que você quer listar.
includeExpired?string
Se true, inclui vencimentos já passados. Padrão false retorna apenas vencimentos futuros.
Default
"false"Value in
"true" | "false"Response Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://brapi.dev/api/v2/options/expirations?underlying=PETR4"{
"underlying": "PETR4",
"tradedOnly": true,
"expirations": [
"2026-12-04",
"2026-12-11",
"2026-12-18"
],
"requestedAt": "2026-06-02T12:00:00.000Z",
"took": 4
}{
"error": true,
"message": "Parâmetros inválidos",
"code": "BAD_REQUEST"
}{
"error": true,
"message": "Token de autenticação inválido ou ausente",
"code": "UNAUTHORIZED"
}{
"error": true,
"message": "Você não tem permissão para acessar este recurso",
"code": "FORBIDDEN"
}{
"error": true,
"message": "Erro interno do servidor",
"code": "INTERNAL_SERVER_ERROR"
}