FuturosOpções sobre Futuros
Cadeia de Opções sobre Futuros
Retorna todas as séries (calls e puts) do vencimento, com o último preço até a data pedida.
Cada série tem:
- Dados do contrato:
symbol,optionType(call/put),optionStyle(american/european),strike,expirationDate,contractMultiplier,allocationRoundLot,automaticExercise. - Cotação do dia: OHLC,
referencePrice,oscillationPct,trades,volume,financialVolume.
Filtros opcionais: side=call|put, minStrike, maxStrike.
A maioria das séries longe do preço atual tem pouca negociação. close
pode vir null em muitas linhas — o referencePrice pode estar
preenchido mesmo sem negócio.
Plano Pro. Sem token, aceita só underlying=BGI.
Authorization
Bearer AuthorizationBearer <token>
Token de API obtido no dashboard em brapi.dev/dashboard
In: header
Query Parameters
underlying*string
Código do ativo (ex.: BGI).
expirationDate*string
Data de vencimento (YYYY-MM-DD).
date?string
Data da cotação (YYYY-MM-DD). Padrão: último pregão.
side?string
Filtra por call ou put.
Value in
"call" | "put"minStrike?number
Strike mínimo (em reais).
maxStrike?number
Strike máximo (em reais).
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://brapi.dev/api/v2/futures/options/chain?underlying=BGI&expirationDate=2026-05-29"{
"underlying": "BGI",
"expirationDate": "2026-05-29",
"date": "2026-05-20",
"series": [
{
"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",
"date": 1779235200,
"open": null,
"high": 3,
"low": 3,
"average": 3,
"close": 3,
"referencePrice": 3.26,
"oscillationPct": null,
"trades": 2,
"volume": 4,
"financialVolume": 3960
},
{
"symbol": "BGIK26P034300",
"underlyingAsset": "BGI",
"underlyingFuture": null,
"optionType": "put",
"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": "BRBMEFKB0200",
"cficCode": "OPAFPS",
"date": 1779235200,
"open": null,
"high": 1.2,
"low": 1.1,
"average": 1.15,
"close": 1.2,
"referencePrice": 1.18,
"oscillationPct": null,
"trades": 1,
"volume": 2,
"financialVolume": 792
}
],
"requestedAt": "2026-05-21T03:00:00.000Z",
"took": 54
}{
"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"
}