Cadeia, strikes, histórico, gregas e volatilidade implícita de opções cujo ativo base é um contrato futuro.
Os ativos com mais liquidez são boi gordo (BGI), café arábica (ICF), milho
(CCM) e soja (SJC). Existem também CNL, os DI de D11 a D17, ETH,
GLD, ISP e SOY, com volume bem menor.
Para opções de ações, ETFs, índices e opções sobre o dólar à vista DOL/WDO, veja opções.
Opções de boi gordo respondem sem token. Cole no terminal:
curl "https://brapi.dev/api/v2/futures/options/expirations?underlying=BGI"| Você quer | Endpoint |
|---|---|
| Vencimentos de um ativo | /api/v2/futures/options/expirations |
| Strikes de um vencimento | /api/v2/futures/options/strikes |
| Calls e puts de um vencimento | /api/v2/futures/options/chain |
| Histórico de uma série | /api/v2/futures/options/historical |
| Gregas e IV de um vencimento | /api/v2/futures/options/analytics |
| Gregas e IV de uma série no tempo | /api/v2/futures/options/analytics/history |
| Contratos em aberto de um vencimento | /api/v2/futures/options/positions |
| Contratos em aberto de uma série no tempo | /api/v2/futures/options/positions/history |
O caminho normal é expirations para achar a data, depois chain para as
séries. Se você já sabe a série, vá direto para historical.
Opções sobre futuros são do plano Pro, junto com os futuros. Sem token, os
endpoints respondem apenas para boi gordo (BGI).
O histórico cobre cerca de 1 ano e entra depois do pregão, por volta das 19h de Brasília. A cobertura inclui opções listadas sobre futuros de commodity e financeiros.
Contratos em aberto saem em posições em aberto.
O campo openInterest também acompanha cada série em chain e analytics.
As gregas e a volatilidade implícita são calculadas sobre o fechamento, com Black-76 para opções europeias e aproximação binomial para americanas.
O fuso é America/Sao_Paulo. Nas respostas de preço e histórico, date é
timestamp Unix em segundos. Nas de analytics, date vem em YYYY-MM-DD.
| Campo | O que é |
|---|---|
underlyingAsset | Código do futuro que serve de base, como BGI ou ICF |
symbol | Código da opção, no padrão {ATIVO}{LETRA_MÊS}{ANO}{C|P}{STRIKE×100}. BGIH27C028550 é uma call sobre BGI, março de 2027, strike R$ 285,50 |
optionStyle | american permite exercer a qualquer momento, european só no vencimento. Opções de commodity são quase sempre americanas |
optionType | call ou put |
strike | Preço de exercício, em reais |
contractMultiplier | Vem do futuro. Opção de boi usa 330, o número de arrobas |
allocationRoundLot | Tamanho do lote. Quase sempre 1 |
automaticExercise | Quando true, a opção é exercida sozinha no vencimento se valer a pena |