BRbrapi-dev
Opções sobre Futuros

Posições em aberto de opções sobre futuros

Changed on

Retorna os contratos em aberto de cada série de opções sobre futuro de um vencimento.

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. Aqui ele repete reportedOpenInterest. Os campos de posição coberta, descoberta, bloqueada e de empréstimo vêm vazios na maior parte dos segmentos de futuros. 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 sobre futuros: side, minStrike e maxStrike.

Disponível no plano Pro. Sem token, aceita só underlying=BGI.

get/api/v2/futures/options/positions

Request

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

Query parameters

underlyingstring required

Código do ativo do futuro. Ex.: BGI.

Example:BGI
expirationDatestring required

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

Example:2027-08-31
datestring

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

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": "BGI",
  "expirationDate": "2027-08-31",
  "date": "2026-06-01",
  "positions": [
    {
      "symbol": "BGIM26C028000",
      "underlyingAsset": "BGI",
      "underlyingFuture": null,
      "optionType": "call",
      "optionStyle": "american",
      "segment": "agribusiness",
      "strike": 280,
      "expirationDate": "2027-08-31",
      "firstTradeDate": "2026-03-09",
      "lastTradeDate": "2027-08-31",
      "contractMultiplier": 330,
      "allocationRoundLot": 1,
      "exerciseType": null,
      "automaticExercise": null,
      "premiumUpfront": true,
      "isin": "BRBMEFCBMMP7",
      "cficCode": "OCAFPS",
      "openInterest": 2441,
      "openInterestChange": -22,
      "openInterestDate": "2026-06-01",
      "reportDate": "2026-06-01",
      "asset": "BGI",
      "expirationCode": "VVNK",
      "reportSegment": "AGRIBUSINESS",
      "reportedOpenInterest": 2441,
      "reportedOpenInterestChange": -22,
      "distributionId": null,
      "coveredQuantity": null,
      "blockedQuantity": null,
      "uncoveredQuantity": null,
      "totalPositionQuantity": null,
      "borrowerQuantity": null,
      "lenderQuantity": null,
      "currentQuantity": null,
      "forwardPrice": null
    }
  ],
  "requestedAt": "2026-06-02T12:00:00.000Z",
  "took": 14
}

Changes