Use esta API para consultar opções cujo ativo-base é um contrato futuro. Ela é útil para telas de cadeia, histórico EOD, gregas e volatilidade implícita de commodities e futuros financeiros.
Na bolsa brasileira, os principais ativos são:
BGI)ICF)CCM)SJC)CNL, D11–D17 (DI), ETH, GLD, ISP, SOY.Esta seção é para opções sobre futuros. Para opções de ações, ETFs e índices (PETR4, VALE3, BOVA11 etc.), veja Opções.
Dados disponíveis
A API entrega vencimentos, strikes, cadeia de opções, histórico EOD, volatilidade implícita e gregas calculadas para opções europeias e americanas.
America/Sao_Paulo. Em respostas de preços/histórico,
date é um número (Unix em segundos); em respostas de analytics, date vem
em YYYY-MM-DD.underlyingAsset): o código do futuro que serve de base
(ex.: BGI, ICF).symbol): padrão do mercado
{ATIVO}{LETRA_MÊS_FUTURO}{ANO}{C|P}{STRIKE×100}. Ex.:
BGIH27C028550 = call sobre BGI, vencimento março/2027, strike
R$ 285,50.optionStyle): american (pode exercer a qualquer momento)
ou european (só no vencimento). Opções sobre commodities são quase
sempre american.optionType): call (compra) ou put (venda).strike): preço combinado, em reais.contractMultiplier): vem do futuro. Ex.: opções de
boi têm multiplicador 330 (arrobas).allocationRoundLot): quase sempre 1.automaticExercise): se true, a opção é
exercida sozinha no vencimento quando vale a pena.Opções sobre futuros estão no plano Pro, junto com os futuros.
| Plano | Acesso |
|---|---|
| Sem token (sandbox) | BGI (boi gordo) |
| Free | Não incluso |
| Startup | Não incluso |
| Pro | Todos os ativos |
Exemplo do fluxo vencimentos → cadeia → histórico para opções de boi
gordo (BGI). Funciona no sandbox sem token.
# 1) Vencimentos disponíveis
curl "https://brapi.dev/api/v2/futures/options/expirations?underlying=BGI"
# 2) Cadeia (calls + puts) de um vencimento
curl "https://brapi.dev/api/v2/futures/options/chain?underlying=BGI&expirationDate=2026-05-29"
# 3) Histórico de uma série
curl "https://brapi.dev/api/v2/futures/options/historical?symbol=BGIK26C034300"Comece em
/api/v2/futures/options/expirations
com o ativo do subjacente (ex.: BGI, ICF).
Use
/api/v2/futures/options/strikes
para ver os strikes do vencimento. Filtre por side=call ou
side=put.
Use /api/v2/futures/options/chain para
todas as séries do vencimento, com último preço.
Use
/api/v2/futures/options/analytics
para a foto EOD de um vencimento, ou
/api/v2/futures/options/analytics/history
para a série temporal de uma opção específica.
Quando souber a série, use
/api/v2/futures/options/historical.
expirations → chainchain?minStrike=X&maxStrike=Yexpirations → analyticschain para escolher a série,
depois historical e analytics/history.Vencimentos disponíveis para um ativo.
Strikes disponíveis em um vencimento.
Todas as calls e puts de um vencimento com preço e volume.
Volatilidade implícita e gregas por vencimento.
Série diária de gregas e IV de uma opção sobre futuro.
Série diária de uma opção.