Contratos em aberto de todas as calls e puts de um vencimento.
Open interest conta quantos contratos seguem vivos. Volume conta quantos trocaram de mãos no pregão. Em opções sobre boi, café, milho e soja muita série passa dias sem negócio e mantém posição aberta, então os dois números respondem perguntas diferentes.
Use openInterest como número de contratos em aberto. Aqui ele repete
reportedOpenInterest.
Filtre com side=call|put, minStrike e maxStrike.
coveredQuantity, uncoveredQuantity, blockedQuantity e
totalPositionQuantity chegam null na maior parte dos segmentos de futuros.
Essa quebra existe principalmente nas opções sobre
ações.
A apuração sai uma vez por pregão. Quando ainda não há apuração para a data
pedida, a resposta traz a apuração anterior. Leia openInterestDate antes de
comparar a posição com o preço do dia.
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 (ex.: BGI).
Data de vencimento (YYYY-MM-DD).
Data da cotação (YYYY-MM-DD). Padrão: último pregão.
Filtra por call ou put.
Value in
Strike mínimo (em reais).
Strike máximo (em reais).
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=2026-08-31"{ "underlying": "BGI", "expirationDate": "2026-08-31", "date": "2026-06-01", "positions": [ { "symbol": "BGIM26C028000", "underlyingAsset": "BGI", "underlyingFuture": null, "optionType": "call", "optionStyle": "american", "segment": "agribusiness", "strike": 280, "expirationDate": "2026-08-31", "firstTradeDate": "2026-03-09", "lastTradeDate": "2026-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}