BRbrapi-dev
Opções sobre Futuros

Cadeia de opções sobre futuros

Changed on

Retorna as calls e puts de um vencimento de opções sobre futuro, com dados do contrato (symbol, optionType, optionStyle, strike, contractMultiplier) e a cotação do pregão: OHLC, referencePrice, volume e contratos em aberto.

Use para montar uma tela de opções por vencimento, comparar calls e puts por strike e filtrar séries por faixa de strike.

Todas as séries vêm do mesmo pregão: o último com dados até a data pedida, informado em date. Séries sem registro nesse pregão não aparecem.

Muitas séries não negociam todo dia. Sem negócio, close vem null e referencePrice costuma vir preenchido.

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

get/api/v2/futures/options/chain

Request

  • Base URL
    https://brapi.dev
  • URL
    https://brapi.dev/api/v2/futures/options/chain
  • 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

Séries 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",
  "series": [
    {
      "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",
      "date": 1780272000,
      "open": null,
      "high": null,
      "low": null,
      "average": null,
      "close": null,
      "referencePrice": 68.57,
      "oscillationPct": null,
      "trades": null,
      "volume": null,
      "financialVolume": null,
      "openInterest": 2441,
      "openInterestChange": -22,
      "openInterestDate": "2026-06-01"
    },
    {
      "symbol": "BGIM26P028000",
      "underlyingAsset": "BGI",
      "underlyingFuture": null,
      "optionType": "put",
      "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": "BRBMEFVBMMP7",
      "cficCode": "OPAFPS",
      "date": 1780272000,
      "open": null,
      "high": null,
      "low": null,
      "average": null,
      "close": null,
      "referencePrice": 0.01,
      "oscillationPct": null,
      "trades": null,
      "volume": null,
      "financialVolume": null,
      "openInterest": 2441,
      "openInterestChange": -22,
      "openInterestDate": "2026-06-01"
    }
  ],
  "requestedAt": "2026-06-02T12:00:00.000Z",
  "took": 54
}

Changes

  • 40fae0b2d5fbRevision changes
    • info

      added the required property // to the response with the status

    • info

      added the required property // to the response with the status

    • info

      added the required property // to the response with the status

  • c9743d203cb0Revision changes
    • info

      endpoint added