BRbrapi-dev
Opções sobre Futuros

Histórico de opção sobre futuro

Changed on

Retorna o histórico diário de uma opção sobre futuro, identificada por symbol: dados do contrato e, por pregão, OHLC, referencePrice, oscillationPct, negócios e volume.

Use para montar gráficos de prêmio, fazer backtests e analisar a liquidez de uma série.

Encontre a série na cadeia de opções sobre futuros. Séries longe do preço do futuro quase não negociam, e o histórico pode ter poucos pregões.

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

get/api/v2/futures/options/historical

Request

  • Base URL
    https://brapi.dev
  • URL
    https://brapi.dev/api/v2/futures/options/historical
  • 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 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",
    "history": [
      {
        "date": 1780272000,
        "open": null,
        "high": null,
        "low": null,
        "average": null,
        "close": null,
        "referencePrice": 68.57,
        "oscillationPct": null,
        "trades": null,
        "volume": null,
        "financialVolume": null
      }
    ]
  },
  "requestedAt": "2026-06-02T12:00:00.000Z",
  "took": 33
}

Changes