Câmbio, cripto e derivativos

Cadeia de opções

Opções de um ativo-objeto por vencimento e strike, com prêmio, volume e contratos em aberto.

GEThttps://api.fintay.com.br/v1/derivatives/{market}/chain

Autorização

X-API-Keystringheaderobrigatório

Chave de API criada em API Keys. Veja Chaves e limites.

Parâmetros de rota

marketstringobrigatório

Mercado de opções.

Valores aceitos:optionsfuture_options

Parâmetros de consulta

underlyingstringobrigatório

Ativo-objeto (ex.: PETR4).

expirationstring · date

Vencimento.

sidestring

call ou put.

Valores aceitos:callput

strikenumber

Preço de exercício.

as_ofstring · date

Pregão.

limitintegerpadrão: 200mín. 1 · máx. 500

Máximo de opções.

offsetintegerpadrão: 0mín. 0

Opções a pular.

Resposta

Envelope { success, data, meta }. Campos de data.items[]:

instrument_idstring

Exemplo: b2c94d09-2704-4340-93fc-6adfdaf5592b

symbolstring

Exemplo: PETRJ752

underlyingstring

Exemplo: PETR4

expiration_datestring

Exemplo: 2026-10-16

sidestring

Exemplo: call

strikenumber

Exemplo: 5.21

currencystring

Exemplo: BRL

multipliernull

option_stylestring

Exemplo: european

price_datestring

Exemplo: 2026-09-25T03:00:00+00:00

closenumber

Exemplo: 42.91

volumeinteger

Exemplo: 5700

price_detailsobject

analytics_datenull

analyticsnull

positions_datenull

positionsnull

GETCadeia de opções

curl "https://api.fintay.com.br/v1/derivatives/options/chain?underlying=PETR4&limit=3" \
  -H "X-API-Key: SUA_CHAVE"

Resposta

{
  "success": true,
  "data": {
    "items": [
      {
        "instrument_id": "b2c94d09-2704-4340-93fc-6adfdaf5592b",
        "symbol": "PETRJ752",
        "underlying": "PETR4",
        "expiration_date": "2026-10-16",
        "side": "call",
        "strike": 5.21,
        "currency": "BRL",
        "multiplier": null,
        "option_style": "european",
        "price_date": "2026-09-25T03:00:00+00:00",
        "close": 42.91,
        "volume": 5700,
        "price_details": {
          "ask": 0,
          "bid": 0,
          "low": 42.79,
          "date": 1790305200,
          "high": 43.3,
          "open": 42.94,
          "side": "call",
          "close": 42.91,
          "market": "equity",
          "strike": 5.21,
          "symbol": "PETRJ752",
          "trades": 12,
          "volume": 5700,
          "average": 43.01,
          "optionStyle": "european",
          "openInterest": 104900,
          "lastTradeDate": "2026-09-25",
          "expirationDate": "2026-10-16",
          "firstTradeDate": "2026-08-25",
          "referencePrice": null,
          "financialVolume": 245189,
          "openInterestDate": "2026-09-25",
          "underlyingSymbol": "PETR4",
          "allocationRoundLot": 100,
          "openInterestChange": -4300
        },
        "analytics_date": null,
        "analytics": null,
        "positions_date": null,
        "positions": null
      },
      {
        "instrument_id": "70359862-c648-4276-a730-711bd56afe70",
        "symbol": "PETRJ128",
        "underlying": "PETR4",
        "expiration_date": "2026-10-16",
        "side": "call",
        "strike": 11.61,
        "currency": "BRL",
        "multiplier": null,
        "option_style": "european",
        "price_date": "2026-09-25T03:00:00+00:00",
        "close": 36.5,
        "volume": 800,
        "price_details": {
          "ask": 0,
          "bid": 0,
          "low": 36.44,
          "date": 1790305200,
          "high": 36.5,
          "open": 36.45,
          "side": "call",
          "close": 36.5,
          "market": "equity",
          "strike": 11.61,
          "symbol": "PETRJ128",
          "trades": 8,
          "volume": 800,
          "average": 36.47,
          "optionStyle": "european",
          "openInterest": 8000,
          "lastTradeDate": "2026-09-25",
          "expirationDate": "2026-10-16",
          "firstTradeDate": "2026-09-08",
          "referencePrice": null,
          "financialVolume": 29179,
          "openInterestDate": "2026-09-25",
          "underlyingSymbol": "PETR4",
          "allocationRoundLot": 100,
          "openInterestChange": -800
        },
        "analytics_date": null,
        "analytics": null,
        "positions_date": null,
        "positions": null
      },
      {
        "instrument_id": "0ec599a4-267f-4334-ad14-01720224ab7b",
        "symbol": "PETRJ184",
        "underlying": "PETR4",
        "expiration_date": "2026-10-16",
        "side": "call",
        "strike": 13.11,
        "currency": "BRL",
        "multiplier": null,
        "option_style": "european",
        "price_date": "2026-09-25T03:00:00+00:00",
        "close": 35.1,
        "volume": 500,
        "price_details": {
          "ask": 0,
          "bid": 0,
          "low": 35.1,
          "date": 1790305200,
          "high": 35.1,
          "open": 35.1,
          "side": "call",
          "close": 35.1,
          "market": "equity",
          "strike": 13.11,
          "symbol": "PETRJ184",
          "trades": 1,
          "volume": 500,
          "average": 35.1,
          "optionStyle": "european",
          "openInterest": 9300,
          "lastTradeDate": "2026-09-25",
          "expirationDate": "2026-10-16",
          "firstTradeDate": "2026-08-31",
          "referencePrice": null,
          "financialVolume": 17550,
          "openInterestDate": "2026-09-25",
          "underlyingSymbol": "PETR4",
          "allocationRoundLot": 100,
          "openInterestChange": 0
        },
        "analytics_date": null,
        "analytics": null,
        "positions_date": null,
        "positions": null
      }
    ],
    "has_more": true,
    "offset": 0,
    "note": "Contratos com preço no último pregão até a data de referência. Analytics e posições têm datas próprias; ausência não significa zero."
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json"
  }
}