Retorna o histórico diário de contratos em aberto de uma opção sobre futuro, identificada por symbol.
Use para ver a montagem e a desmontagem de posições ao longo do tempo e comparar contratos em aberto com o preço.
Cada item é uma apuração diária. Pregão sem apuração não aparece.
Disponível no plano Pro. Sem token, aceita só symbol com prefixo BGI.
Bearer Token de API obtido no dashboard em brapi.dev/dashboard
In: header
Código da série de opção.
Data inicial, no formato YYYY-MM-DD. Padrão: 12 meses atrás.
Data final, no formato YYYY-MM-DD. Padrão: hoje.
Ordem por data: asc do mais antigo ao mais recente, desc do mais recente ao mais antigo.
"desc"Value in
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/api/v2/futures/options/positions/history?symbol=BGIM26C028000"{ "option": { "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", "positions": [ { "openInterest": 2441, "openInterestChange": -22, "openInterestDate": "2026-06-01", "reportDate": "2026-06-01", "isin": "BRBMEFCBMMP7", "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": 13}