BRbrapi-dev
Opções sobre Futuros

Histórico de posições em aberto de opções sobre futuros

Changed on

Retorna o histórico diário de contratos em aberto de uma opção sobre futuro, identificada por symbol.

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.

Disponível no plano Pro. Sem token, aceita só symbol com prefixo BGI.

get/api/v2/futures/options/positions/history

Request

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

Query parameters

symbolstring required

Código da série de opção.

Example:BGIM26C028000
startDatestring

Data inicial, no formato YYYY-MM-DD. Padrão: 12 meses atrás.

Example:2026-05-01
endDatestring

Data final, no formato YYYY-MM-DD. Padrão: hoje.

Example:2026-06-01
sortOrder'asc' | 'desc'

Ordem por data: asc do mais antigo ao mais recente, desc do mais recente ao mais antigo.

Response

Histórico de posições retornado com sucesso.

requestedAtstring date-time required

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

tookinteger required

Tempo de processamento, em milissegundos.

Example response

{
  "option": {
    "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",
    "positions": [
      {
        "openInterest": 2441,
        "openInterestChange": -22,
        "openInterestDate": "2026-06-01",
        "reportDate": "2026-06-01",
        "isin": "BRBMEFCBMMP7",
        "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": 13
}

Changes