Opções
Histórico de posições em aberto
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 o histórico diário de contratos em aberto de uma série de opção, identificada por symbol e expirationDate.
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. Se o mesmo symbol aparece duas vezes no vencimento, passe também strike.
Disponível no plano Pro. Sem token, aceita só symbol com prefixo PETR.
Bearer Token de API obtido no dashboard em brapi.dev/dashboard
In: header
Código da série de opção.
Data de vencimento da série, no formato YYYY-MM-DD.
Preço de exercício. Use quando o mesmo symbol aparece mais de uma vez no vencimento.
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/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}