Histórico de Opções sobre Futuros
Retorna a série diária de uma opção sobre futuro, pelo symbol
(ex.: BGIK26C034300).
O normal é descobrir a série em Cadeia e depois chamar este endpoint. Ele aceita uma série por vez.
A resposta tem:
- Dados completos do contrato — strike, optionStyle, multiplier, lote, ISIN etc.
- Série diária com negócio — OHLC, referencePrice, oscillationPct, trades, volume, financialVolume.
A maioria das séries longe do preço atual negocia pouco — sua resposta pode ter só alguns dias. Para acompanhar todo dia, escolha a série mais próxima do preço atual.
Plano Pro. Sem token, aceita só symbol começando com BGI.
Authorization
Bearer Token de API obtido no dashboard em brapi.dev/dashboard
In: header
Query Parameters
Código da opção (ex.: BGIK26C034300).
Data inicial (YYYY-MM-DD). Padrão: 12 meses atrás.
Data final (YYYY-MM-DD). Padrão: hoje.
"desc""asc" | "desc"Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://brapi.dev/api/v2/futures/options/historical?symbol=BGIK26C034300"{
"option": {
"symbol": "BGIK26C034300",
"underlyingAsset": "BGI",
"underlyingFuture": null,
"optionType": "call",
"optionStyle": "american",
"segment": "agribusiness",
"strike": 343,
"expirationDate": "2026-05-29",
"firstTradeDate": "2026-05-20",
"lastTradeDate": "2026-05-29",
"contractMultiplier": 330,
"allocationRoundLot": 1,
"exerciseType": null,
"automaticExercise": null,
"premiumUpfront": true,
"isin": "BRBMEFKB01Z9",
"cficCode": "OCAFPS",
"history": [
{
"date": 1779235200,
"open": null,
"high": 3,
"low": 3,
"average": 3,
"close": 3,
"referencePrice": 3.26,
"oscillationPct": null,
"trades": 2,
"volume": 4,
"financialVolume": 3960
}
]
},
"requestedAt": "2026-05-21T03:00:00.000Z",
"took": 33
}{
"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": "Recurso não encontrado",
"code": "NOT_FOUND"
}{
"error": true,
"message": "Erro interno do servidor",
"code": "INTERNAL_SERVER_ERROR"
}