Série diária de contratos em aberto de uma única opção, identificada por
symbol e expirationDate. Quando o mesmo símbolo aparece duas vezes no
vencimento, passe também strike.
Descubra a série em séries negociadas e depois chame aqui.
Cada item é uma apuração diária. Pregão sem apuração não aparece na série.
É aqui que você vê montagem e desmontagem de posição. Open interest subindo junto com o preço indica dinheiro novo entrando na ponta compradora. Open interest caindo indica posição sendo zerada, não necessariamente uma aposta na direção contrária.
Recorte o intervalo com startDate e endDate, e inverta a ordem com
sortOrder.
Plano mínimo: Pro. No sandbox sem token, aceita apenas symbol começando
com PETR (opções do subjacente PETR4).
Bearer Token de API obtido no dashboard em brapi.dev/dashboard
In: header
Símbolo da opção
Data de vencimento no formato YYYY-MM-DD
Preço de exercício. Use quando o mesmo símbolo aparecer mais de uma vez no mesmo vencimento.
Data de início no formato YYYY-MM-DD (padrão: 12 meses)
Data de fim no formato YYYY-MM-DD
Ordem dos pontos em history por data: asc do mais antigo ao mais recente, desc do mais recente ao mais antigo. Padrão desc.
"desc"Value in
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/api/v2/options/positions/history?symbol=PETRF783&expirationDate=2026-12-18"{ "option": { "symbol": "PETRF783", "underlyingSymbol": "PETR4", "side": "call", "market": "equity", "optionStyle": "european", "strike": 7.29, "allocationRoundLot": 100, "expirationDate": "2026-12-18", "firstTradeDate": "2026-04-24", "lastTradeDate": "2026-06-01", "positions": [ { "openInterest": 12500, "openInterestChange": 350, "openInterestDate": "2026-06-01", "reportDate": "2026-06-01", "isin": "BRPETR4F1RM1", "asset": "PETR", "expirationCode": null, "segment": "EQUITY CALL", "reportedOpenInterest": null, "reportedOpenInterestChange": null, "distributionId": "228", "coveredQuantity": 0, "blockedQuantity": 1200, "uncoveredQuantity": 11300, "totalPositionQuantity": 12500, "borrowerQuantity": 1, "lenderQuantity": 3, "currentQuantity": null, "forwardPrice": null } ] }, "requestedAt": "2026-06-02T12:00:00.000Z", "took": 11}