BRbrapi-dev
Opções

Posições em aberto de opções

Changed on

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.

get/api/v2/options/positions

Request

  • Base URL
    https://brapi.dev
  • URL
    https://brapi.dev/api/v2/options/positions
  • Auth
    HTTP bearer

Query parameters

underlyingstring required

Ticker do ativo subjacente: ação, ETF, índice, DOL ou WDO.

Example:PETR4
expirationDatestring required

Data de vencimento, no formato YYYY-MM-DD. Veja os vencimentos em /expirations.

Example:2026-12-18
datestring

Data do pregão, no formato YYYY-MM-DD. Padrão: último pregão disponível.

Example:2026-06-01
side'call' | 'put'

Filtra por call ou put. Sem o filtro, retorna os dois.

minStrikenumber nullable

Strike mínimo.

maxStrikenumber nullable

Strike máximo.

Response

Posições retornadas com sucesso.

underlyingstring required
expirationDatestring required
datestring required
requestedAtstring date-time required

Data e hora da requisição em ISO 8601.

tookinteger required

Tempo de processamento, em milissegundos.

Example response

{
  "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
}

Changes