Opções
Posições em aberto de opções
Carregando conteúdo...
FOR LLMs: add .md to any documentation URL to get the page as Markdown. Example: /docs/acoes/dividendos.md. The index of all pages is at /llms.txt.
Carregando documentação...
Retorna os contratos em aberto de cada série de um vencimento, com a divisão entre posição coberta, descoberta e bloqueada.
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. Nas opções sobre ações, ele vem de totalPositionQuantity, porque reportedOpenInterest vem vazio. 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: side, minStrike e maxStrike.
Disponível no plano Pro. Sem token, aceita só underlying=PETR4.
Bearer Token de API obtido no dashboard em brapi.dev/dashboard
In: header
Ticker do ativo subjacente: ação, ETF, índice, DOL ou WDO.
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/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}