Contratos em aberto de todas as séries de um vencimento, com a quebra entre posição coberta, descoberta e bloqueada.
Open interest conta quantos contratos seguem vivos. Volume conta quantos trocaram de mãos no pregão. Uma série pode passar o dia sem negócio e ainda assim ter milhares de contratos em aberto, então os dois números respondem perguntas diferentes.
Use openInterest como número de contratos em aberto. Nas opções sobre ações
esse valor vem de totalPositionQuantity, porque reportedOpenInterest chega
vazio.
Os filtros são os mesmos de séries negociadas:
side=call|put, minStrike e maxStrike.
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 mínimo: Pro. No sandbox sem token, aceita apenas underlying=PETR4.
Bearer Token de API obtido no dashboard em brapi.dev/dashboard
In: header
Código do ativo subjacente (ação, ETF ou índice) das opções que você quer listar.
Data de vencimento das opções, no formato YYYY-MM-DD. Use /expirations para descobrir os vencimentos disponíveis.
Data EOD usada para buscar preço e volume do dia, no formato YYYY-MM-DD. Padrão: último pregão disponível.
Filtra por tipo da opção: call (compra) ou put (venda). Omita para retornar ambos.
Value in
Strike mínimo a considerar. Útil para limitar a resposta a uma faixa de preços de exercício.
Strike máximo a considerar. Útil para limitar a resposta a uma faixa de preços de exercício.
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/api/v2/options/positions?underlying=PETR4&expirationDate=2026-12-18"{ "underlying": "PETR4", "expirationDate": "2026-12-18", "date": "2026-06-01", "positions": [ { "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", "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": 12}