BRbrapi-dev
Opções

Cadeia de opções

Changed on

Retorna as séries de opções de um vencimento, com dados do contrato (symbol, side, strike, optionStyle) e a cotação do último pregão até date: OHLC, bid, ask, 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.

A lista traz só séries com cotação nos 10 dias até date. Cada série traz a cotação do seu último pregão nessa janela, que pode ser anterior a date. Confira o campo date de cada série antes de usar o preço como atual.

Nas séries de DOL e WDO, referencePrice pode vir preenchido com close, high e low nulos, porque muitas séries não negociam no dia.

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

get/api/v2/options/chain

Request

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

Query parameters

underlyingstring required

Ticker do ativo subjacente: ação, ETF, índice, DOL ou WDO.

Example:PETR4
expirationDatestring required

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

Example:2026-12-18
datestring

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

Example:2026-06-01
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

Ativo subjacente consultado, em maiúsculas.

expirationDatestring required

Vencimento consultado, no formato YYYY-MM-DD.

datestring required

Último pregão com dados até a data pedida, no formato YYYY-MM-DD.

tradedOnlytrue required

Sempre true: a lista traz só séries com cotação nos 10 dias até date.

requestedAtstring date-time required

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

tookinteger required

Tempo de processamento, em milissegundos.

Example response

{
  "underlying": "PETR4",
  "expirationDate": "2026-12-18",
  "date": "2026-06-01",
  "tradedOnly": true,
  "series": [
    {
      "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",
      "openInterest": 12500,
      "openInterestChange": 350,
      "openInterestDate": "2026-06-01",
      "date": 1780282800,
      "open": 35.15,
      "high": 35.15,
      "low": 35.15,
      "average": 35.15,
      "close": 35.15,
      "referencePrice": null,
      "bid": 0,
      "ask": 0,
      "trades": 1,
      "volume": 500,
      "financialVolume": 17575
    }
  ],
  "requestedAt": "2026-06-02T12:00:00.000Z",
  "took": 7
}

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

  • 297945b14cadRevision changes
    • warning

      added the new currency enum value to the // response property for the response status

    • info

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