BRbrapi-dev
Opções

Histórico de posições em aberto

Changed on

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.

get/api/v2/options/positions/history

Request

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

Query parameters

symbolstring required

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

Example:PETRF783
expirationDatestring required

Data de vencimento da série, no formato YYYY-MM-DD.

Example:2026-12-18
strikenumber nullable

Preço de exercício. Use quando o mesmo symbol aparece mais de uma vez no vencimento.

Example:7.29
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": "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
}

Changes