Cadeia, strikes, vencimentos, histórico de fechamento, gregas e volatilidade
implícita de opções sobre ações, ETFs, índices e opções sobre o dólar à vista
(DOL e WDO).
Para opções sobre futuros, como boi gordo, café, milho e soja, veja opções sobre futuros. DOL e WDO usam esta página quando a série é classificada pela B3 como opção sobre spot.
Opções de PETR4 respondem sem token. Cole no terminal:
curl "https://brapi.dev/api/v2/options/expirations?underlying=PETR4"Opções sobre o dólar à vista usam o mesmo endpoint. Elas exigem um token do plano Pro:
curl -H "Authorization: Bearer $BRAPI_TOKEN" \
"https://brapi.dev/api/v2/options/expirations?underlying=DOL"| Você quer | Endpoint |
|---|---|
| Vencimentos de um ativo | /api/v2/options/expirations |
| Strikes de um vencimento | /api/v2/options/strikes |
| Todas as séries de um vencimento | /api/v2/options/chain |
| Histórico de uma série | /api/v2/options/historical |
| Gregas e IV de um vencimento | /api/v2/options/analytics |
| Gregas e IV de uma série no tempo | /api/v2/options/analytics/history |
| Contratos em aberto de um vencimento | /api/v2/options/positions |
| Contratos em aberto de uma série no tempo | /api/v2/options/positions/history |
Use underlying=DOL ou underlying=WDO para consultar opções sobre o dólar à
vista. A resposta identifica essas séries com market=currency.
O caminho normal é expirations para achar a data, depois chain para as
séries. strikes é opcional: chain já aceita minStrike e maxStrike.
Se você já sabe o vencimento, comece em chain. Se já sabe a série, vá direto
para historical.
Opções são do plano Pro. Sem token, expirations, strikes, chain,
analytics e positions respondem com underlying=PETR4, e historical,
analytics/history e positions/history respondem com symbol começando em
PETR.
O histórico de ações, ETFs e índices começa em 2009. O histórico de DOL e WDO segue a janela disponível nos arquivos recentes da B3, de cerca de um ano.
As séries de DOL e WDO podem ter referencePrice preenchido mesmo quando
close, high e low são null, pois muitas séries não têm negócio no dia.
Contratos em aberto saem em posições em aberto. O campo
openInterest também acompanha cada série em chain e analytics. Série sem
apuração no período traz openInterest como null.
O arquivo do dia entra por volta das 19h de Brasília. Antes disso, o "último pregão disponível" ainda é o pregão anterior. Se o seu produto atualiza às 18h, ele mostra o dado de ontem.
O fuso é America/Sao_Paulo. Datas em query params usam YYYY-MM-DD. Na
resposta, historical e chain trazem date como timestamp Unix em segundos,
e os endpoints de analytics trazem date em YYYY-MM-DD.
| Termo | O que é |
|---|---|
| Ativo subjacente | A ação, ETF, índice ou ativo cambial da opção, como PETR4 ou DOL |
expirationDate | A data em que a opção vence, como 2026-05-15 |
| Strike | O preço combinado no contrato, como 34 |
| Série | O contrato que o mercado negocia, identificado por symbol, expirationDate, side e strike |
symbolO padrão da B3 é {ATIVO}{LETRA_MÊS}{ID_STRIKE}.
O ativo são as 4 letras do subjacente, como PETR. A letra do mês carrega
também o tipo: de A a L são calls, de janeiro a dezembro, e de M a X
são puts, na mesma ordem. No fim vem o ID do strike, um número de 1 a 3 dígitos
que a bolsa atribui.
Assim PETRE370 é uma call de PETR4 com vencimento em maio, e PETRQ28 é uma
put de PETR4, também de maio.
O ID do strike não é o valor em reais. Para o strike em reais, use
/api/v2/options/chain ou
/api/v2/options/strikes.
O que são contratos em aberto e por que não é a mesma coisa que volume.
Puxe posições em aberto de um vencimento ou de uma série em Python.
Entenda calls, puts, strikes e vencimentos do zero, em português.
Como usar opções para gerar renda extra sobre ações que você já tem.
Monte uma options chain visual com calls e puts.
Teste covered call e cash-secured put com PETR4.
Puxe histórico da brapi e teste estratégias em notebook Python.