Retorna os contratos em aberto de cada série de opções sobre futuro de um vencimento.
Use para ver onde se concentram as posições por strike, comparar calls e puts e acompanhar a variação diária de contratos em aberto.
Use openInterest como número de contratos em aberto. Aqui ele repete reportedOpenInterest. Os campos de posição coberta, descoberta, bloqueada e de empréstimo vêm vazios na maior parte dos segmentos de futuros. Volume e contratos em aberto medem coisas diferentes: uma série pode ficar sem negócio e ter muitos contratos em aberto.
Os contratos em aberto são apurados uma vez por pregão. Sem apuração na data pedida, a resposta traz a anterior. Confira openInterestDate antes de comparar com o preço do dia.
Aceita os mesmos filtros da cadeia de opções sobre futuros: side, minStrike e maxStrike.
Disponível no plano Pro. Sem token, aceita só underlying=BGI.
Bearer Token de API obtido no dashboard em brapi.dev/dashboard
In: header
Código do ativo do futuro. Ex.: BGI.
Data de vencimento, no formato YYYY-MM-DD. Veja os vencimentos em /expirations.
Data do pregão, no formato YYYY-MM-DD. Padrão: último pregão disponível.
Filtra por call ou put. Sem o filtro, retorna os dois.
Value in
Strike mínimo.
Strike máximo.
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/api/v2/futures/options/positions?underlying=BGI&expirationDate=2027-08-31"{ "underlying": "BGI", "expirationDate": "2027-08-31", "date": "2026-06-01", "positions": [ { "symbol": "BGIM26C028000", "underlyingAsset": "BGI", "underlyingFuture": null, "optionType": "call", "optionStyle": "american", "segment": "agribusiness", "strike": 280, "expirationDate": "2027-08-31", "firstTradeDate": "2026-03-09", "lastTradeDate": "2027-08-31", "contractMultiplier": 330, "allocationRoundLot": 1, "exerciseType": null, "automaticExercise": null, "premiumUpfront": true, "isin": "BRBMEFCBMMP7", "cficCode": "OCAFPS", "openInterest": 2441, "openInterestChange": -22, "openInterestDate": "2026-06-01", "reportDate": "2026-06-01", "asset": "BGI", "expirationCode": "VVNK", "reportSegment": "AGRIBUSINESS", "reportedOpenInterest": 2441, "reportedOpenInterestChange": -22, "distributionId": null, "coveredQuantity": null, "blockedQuantity": null, "uncoveredQuantity": null, "totalPositionQuantity": null, "borrowerQuantity": null, "lenderQuantity": null, "currentQuantity": null, "forwardPrice": null } ], "requestedAt": "2026-06-02T12:00:00.000Z", "took": 14}