Derivativos••5 min
Guia de Integração: Opções (Derivativos)
Guia completo para integrar dados de opções da B3: vencimentos, strikes e séries negociadas via API brapi.
Imagem gerada por IA para o Acoes.capital
Esta API foi desenhada para o fluxo mais comum de consulta de opções na bolsa brasileira (B3):
1
Escolher o ativo subjacente (ex: PETR4)
2
Descobrir os vencimentos disponíveis
3
Ver os preços de exercício (strikes)
4
Listar as séries negociadas (chain)
5
Pegar o histórico de uma série específica
ℹ️ O que esta API entrega
Dados EOD (End of Day) de opções: preço de abertura, máxima, mínima, média, fechamento, bid, ask, negócios e volume financeiro.
⚠️ Limitações da Versão
Não há dados em tempo real, gregas (Delta/Gamma), volatilidade implícita ou interesse em aberto nesta versão.
Acesso por Plano
Opções fazem parte do plano Pro. No entanto, é possível testar usando o Sandbox (sem token) para o ativo PETR4.
| Plano | Acesso a Opções |
|---|---|
| Sandbox (Sem Token) | ✅ Apenas PETR4 |
| Free / Startup | ❌ Bloqueado |
| Pro | ✅ Todos os Ativos |
Termos Importantes
- Vencimento (Expiration): Data em que a opção deixa de existir.
- Strike: Preço pelo qual o ativo pode ser comprado/vendido no exercício.
- Call: Direito de compra.
- Put: Direito de venda.
- Americanas: Podem ser exercidas a qualquer momento.
- Europeias: Exercidas apenas no vencimento (comum em índices).
Exemplos de Uso (cURL)
# 1) Descubra os vencimentos disponíveis
curl "https://brapi.dev/api/v2/options/expirations?underlying=PETR4"
# 2) Liste as séries negociadas em um vencimento
curl "https://brapi.dev/api/v2/options/chain?underlying=PETR4&expirationDate=2026-05-15"
# 3) Consulte o histórico de uma série específica
curl "https://brapi.dev/api/v2/options/historical?symbol=PETRE370&expirationDate=2026-05-15"
Fluxo de Integração
- Consulte
/expirationspara saber quais datas estão disponíveis. - Consulte
/strikesou/chainpara ver os preços disponíveis naquela data. - Use
/historicalpara obter os dados de fechamento diários da série escolhida.