24s Hacim—Açık pozisyon—24s Likidasyon$1.36B24s Long/Short—BTC Hakimiyeti—ETH Hakimiyeti—
Uygulama
Dil ▾
₺ TRY ▾
/api/sd/options/expiries
GETAksamalıSTALE

Vade sonuna göre opsiyonlar

Her vade sonu tarihi için bir satır: açık pozisyon, hacim, put/call oranı, maksimum acı, ATM IV ve skew; tüm borsalar ya da tek bir borsa için.

GET/api/sd/options/expiries
Aksamalı. Uç nokta veri kalitesini STALE olarak bildiriyor

İstek

Sorgu parametreleri

AdTürZorunluVarsayılanİzin verilen değerlerAçıklama
coinstringZorunlu——Coin sembolü, büyük/küçük harfe duyarsız (örneğin `BTC`). Eksik veya hatalı biçimli değerler 400 döndürür. Örnek: BTC
exchangestringİsteğe bağlıallall, deribit, binance, bybit, okx, gate, coincallTek bir borsa veya borsalar arası toplu değer için `all`.

Örnek istek

curl -s "https://www.coinboss.com/api/sd/options/expiries?coin=BTC"

Yanıt alanları

Alan tablosu gerçek yanıtlardan üretilir; dolayısıyla uç noktanın tam olarak ne döndürdüğünü listeler. Yollarda a[] dizi öğelerini, {*} ise coin veya borsa gibi dinamik bir adla anahtarlanan nesneleri gösterir.

AlanTürBirimAçıklama
successboolean—İstek başarılıysa true. Başarısızlık durumunda gövde `{ success: false, code, error, request_id }` olur.
schemastring—Bu yanıtın şema kimliği. Yalnızca mevcut bir alanın anlamı veya türü değiştiğinde değişir.
nownumbermsYanıtın oluşturulduğu andaki sunucu zamanı.
coinstring—Coin sembolü (büyük harf).
exchangestring—Borsa kimliği (küçük harf).
n_expiriesnumber—Dahil edilen vade sonu tarihi sayısı.
n_contractsnumber—Dahil edilen opsiyon sözleşmesi sayısı.
oi_usdnumberUSDUSD nominal değeri olarak açık pozisyon: coin miktarı × spot endeks fiyatı. Tek taraflı.
call_oi_usdnumberUSDCall açık pozisyonu, USD nominal değeri.
put_oi_usdnumberUSDPut açık pozisyonu, USD nominal değeri.
oi_coinnumbercoinDayanak coin birimi cinsinden açık pozisyon.
call_oi_coinnumbercoinDayanak coin birimi cinsinden call açık pozisyonu.
put_oi_coinnumbercoinDayanak coin birimi cinsinden put açık pozisyonu.
vol_usd_24hnumberUSD24h nominal hacim: işlem gören coin miktarı × güncel spot endeks fiyatı. Prim işlem hacmi değildir.
call_vol_usd_24hnumberUSDCall'ların 24h nominal hacmi.
put_vol_usd_24hnumberUSDPut'ların 24h nominal hacmi.
vol_coin_24hnumbercoinDayanak coin birimi cinsinden 24h işlem miktarı.
call_vol_coin_24hnumbercoinCall'ların coin cinsinden 24h işlem miktarı.
put_vol_coin_24hnumbercoinPut'ların coin cinsinden 24h işlem miktarı.
vol_premium_usd_24hnumberUSDBorsanın yayımladığı yerlerde 24h prim işlem hacmi (opsiyon fiyatı × miktar); diğerlerinde `null`. Hiçbir zaman nominal hacme eklenmez.
pcr_oinumberratioPut açık pozisyonu ÷ call açık pozisyonu, coin birimi cinsinden; call tarafı 0 ise `null`.
pcr_volnumberratioPut 24h hacmi ÷ call 24h hacmi, coin birimi cinsinden; call tarafı 0 ise `null`.
atm_iv_30dnumber%Sabit 30 günlük vadeye doğrusal enterpolasyonla getirilen ATM IV; 30 gün iki vade sonu arasında kalmıyorsa `null`.
expiriesarray—Her vade sonu tarihi için bir satır.
expiries[]object—Her vade sonu tarihi için bir satır.
expiries[].expirystring—Vade sonu tarihi (UTC), `YYYY-MM-DD` veya `all`.
expiries[].expiry_tsnumbermsVade sonu zamanı.
expiries[].days_leftnumberdaysVade sonuna kalan gün sayısı.
expiries[].exchangesarray—Bu satıra dahil edilen borsalar.
expiries[].exchanges[]string—Bu satıra dahil edilen borsalar.
expiries[].n_contractsnumber—Dahil edilen opsiyon sözleşmesi sayısı.
expiries[].oi_usdnumberUSDUSD nominal değeri olarak açık pozisyon: coin miktarı × spot endeks fiyatı. Tek taraflı.
expiries[].call_oi_usdnumberUSDCall açık pozisyonu, USD nominal değeri.
expiries[].put_oi_usdnumberUSDPut açık pozisyonu, USD nominal değeri.
expiries[].oi_coinnumbercoinDayanak coin birimi cinsinden açık pozisyon.
expiries[].call_oi_coinnumbercoinDayanak coin birimi cinsinden call açık pozisyonu.
expiries[].put_oi_coinnumbercoinDayanak coin birimi cinsinden put açık pozisyonu.
expiries[].vol_usd_24hnumberUSD24h nominal hacim: işlem gören coin miktarı × güncel spot endeks fiyatı. Prim işlem hacmi değildir.
expiries[].call_vol_usd_24hnumberUSDCall'ların 24h nominal hacmi.
expiries[].put_vol_usd_24hnumberUSDPut'ların 24h nominal hacmi.
expiries[].vol_coin_24hnumbercoinDayanak coin birimi cinsinden 24h işlem miktarı.
expiries[].call_vol_coin_24hnumbercoinCall'ların coin cinsinden 24h işlem miktarı.
expiries[].put_vol_coin_24hnumbercoinPut'ların coin cinsinden 24h işlem miktarı.
expiries[].vol_premium_usd_24hnumber|nullUSDBorsanın yayımladığı yerlerde 24h prim işlem hacmi (opsiyon fiyatı × miktar); diğerlerinde `null`. Hiçbir zaman nominal hacme eklenmez.
expiries[].pcr_oinumberratioPut açık pozisyonu ÷ call açık pozisyonu, coin birimi cinsinden; call tarafı 0 ise `null`.
expiries[].pcr_volnumberratioPut 24h hacmi ÷ call 24h hacmi, coin birimi cinsinden; call tarafı 0 ise `null`.
expiries[].oi_share_pctnumber%Seçimin toplam açık pozisyonu (USD nominal değeri) içindeki pay.
expiries[].max_painnumberUSDVade sonunda opsiyon sahiplerine yapılacak toplam ödemenin en küçük olduğu kullanım fiyatı.
expiries[].max_pain_usdnumberUSDVade sonu maksimum acı kullanım fiyatında uzlaşırsa opsiyon sahiplerine yapılacak toplam ödeme.
expiries[].atm_ivnumber%Başa baş (at-the-money) zımni volatilite: forward fiyata en yakın kullanım fiyatındaki ortalama işaret IV'si.
expiries[].atm_strikenumberUSDForward fiyata en yakın kullanım fiyatı; ATM IV için kullanılır.
expiries[].skew_25dnumber|nullpercentage pointsDeltası −0.25'e en yakın put'un IV'si eksi deltası +0.25'e en yakın call'un IV'si. Yalnızca borsanın yayımladığı deltalar kullanılır.
expiries[].skew_exchangesarray—Skew için deltaları mevcut olan borsalar.
expiries[].skew_exchanges[]string—Skew için deltaları mevcut olan borsalar.
expiries[].index_pricenumberUSDUSD'ye çevirmede kullanılan spot endeks fiyatı (toplu değerlerde borsaların kendi endeks fiyatlarının medyanı).
expiries[].underlying_pricenumber|nullUSDBorsanın bu vade sonu için yayımladığı forward / dayanak varlık fiyatı.
expiries[].by_exchange_ivarray—Bu vade sonunun borsa bazında ATM IV'si.
expiries[].by_exchange_iv[]object—Bu vade sonunun borsa bazında ATM IV'si.
expiries[].by_exchange_iv[].exchangestring—Borsa kimliği (küçük harf).
expiries[].by_exchange_iv[].atm_ivnumber%Başa baş (at-the-money) zımni volatilite: forward fiyata en yakın kullanım fiyatındaki ortalama işaret IV'si.
expiries[].by_exchange_iv[].atm_strikenumberUSDForward fiyata en yakın kullanım fiyatı; ATM IV için kullanılır.
expiries[].by_exchange_iv[].ref_pricenumberUSDBorsanın ATM kullanım fiyatının seçilmesinde esas alınan forward fiyat.
expiries[].by_exchange_iv[].skew_25dnumber|nullpercentage pointsDeltası −0.25'e en yakın put'un IV'si eksi deltası +0.25'e en yakın call'un IV'si. Yalnızca borsanın yayımladığı deltalar kullanılır.
expiries[].by_exchange_iv[].oi_usdnumberUSDUSD nominal değeri olarak açık pozisyon: coin miktarı × spot endeks fiyatı. Tek taraflı.
coverageobject—Sayılara nelerin dahil olduğu ve nelerin olmadığı. Toplamları başka bir kaynakla karşılaştırmadan önce bunu karşılaştırın.
coverage.included_exchangesarray—Güncel verisi dahil edilen kaynaklar.
coverage.included_exchanges[]string—Güncel verisi dahil edilen kaynaklar.
coverage.unavailablearray—Dahil edilemeyen kaynaklar; her biri nedeniyle birlikte. Hiçbir zaman 0 olarak sayılmazlar.
coverage.unavailable[]object—Dahil edilemeyen kaynaklar; her biri nedeniyle birlikte. Hiçbir zaman 0 olarak sayılmazlar.
coverage.unavailable[].exchangestring—Borsa kimliği (küçük harf).
coverage.unavailable[].reasonstring—Makine tarafından okunabilir neden kodu.
coverage.unavailable[].detailstring—Nedenin insan tarafından okunabilir açıklaması.
coverage.stale_excludedarray—Son güncellemesi güncellik penceresinin dışında kaldığı için hariç bırakılan satırlar. bu tabloyu üretmek için kullanılan örneklerde boş
coverage.field_gapsarray—Bir borsanın yayımlamadığı sütunlar; o borsa için `null` olur.
coverage.field_gaps[]object—Bir borsanın yayımlamadığı sütunlar; o borsa için `null` olur.
coverage.field_gaps[].exchangestring—Borsa kimliği (küçük harf).
coverage.field_gaps[].fieldsarray—Eksik sütunların adları.
coverage.field_gaps[].fields[]string—Eksik sütunların adları.
coverage.field_gaps[].kindstring—Sözleşme ailesi: `inverse` (coin ile uzlaşan) veya `linear` (stablecoin ile uzlaşan).
methodobject—Bu yanıtta kullanılan formüllerin düz metin açıklaması; alan başına bir girdi.
method.oi_usdstring—`oi_usd` için formül notu, düz metin.
method.vol_usd_24hstring—`vol_usd_24h` için formül notu, düz metin.
method.vol_premium_usd_24hstring—`vol_premium_usd_24h` için formül notu, düz metin.
method.pcr_oistring—`pcr_oi` için formül notu, düz metin.
method.pcr_volstring—`pcr_vol` için formül notu, düz metin.
method.max_painstring—`max_pain` için formül notu, düz metin.
method.atm_ivstring—`atm_iv` için formül notu, düz metin.
method.atm_iv_30dstring—`atm_iv_30d` için formül notu, düz metin.
method.skew_25dstring—`skew_25d` için formül notu, düz metin.
method.expirystring—`expiry` için formül notu, düz metin.
method.oi_share_pctstring—`oi_share_pct` için formül notu, düz metin.
metaobject—Bu yanıtın veri kökeni ve güncelliği.
meta.schemastring—Bu yanıtın şema kimliği. Yalnızca mevcut bir alanın anlamı veya türü değiştiğinde değişir.
meta.sourcearray—Verinin toplandığı herkese açık kaynak uç noktaları.
meta.source[]object—Verinin toplandığı herkese açık kaynak uç noktaları.
meta.source[].exchangestring—Borsa kimliği (küçük harf).
meta.source[].endpointstring—Toplayıcının okuduğu kaynağın herkese açık uç noktası (veri kökeni için gösterilir; istemciler bunu hiçbir zaman çağırmaz).
meta.observed_atnumbermsKaynağın veri için verdiği zaman damgası.
meta.received_atnumbermsCoinBoss toplayıcısının veriyi aldığı zaman.
meta.fetched_atnumbermsBu yanıtın oluşturulduğu zaman.
meta.windowstring—Sayıların kapsadığı zaman penceresi.
meta.qualitystring—Veri zaman damgalarına ve kapsama göre değerlendirilen FRESH, PARTIAL, STALE, BROKEN veya UNAVAILABLE.
meta.is_staleboolean—Veri güncellik penceresinden eskiyse true.
meta.cache_ttl_snumbersBu yanıtın önbellek ömrü.
meta.fallbackstring—Toplayıcı veya bir kaynak başarısız olduğunda uç noktanın ne döndürdüğü.

Üretilme zamanı: 2026-11-11 23:00 UTC; kaynak: 3 gerçek yanıt.

Örnek yanıt

/api/sd/options/expiries?coin=BTC · Gerçek yanıt, yakalanma zamanı: 2026-11-13 03:58:20 UTC. Uzun diziler ve eşlemeler görüntüleme için kısaltılmıştır: expiries: 12 öğe içeriyordu; meta.source: 6 öğe içeriyordu; coverage.field_gaps: 4 öğe içeriyordu; coverage.unavailable: 12 öğe içeriyordu; coverage.stale_included: 6 öğe içeriyordu; expiries[].by_exchange_iv: 6 öğe içeriyordu.

  • {
    • "success": true,
    • "schema": "coinboss.sd.options/1",
    • "now": 1794542300391,
    • "coin": "BTC",
    • "exchange": "all",
    • "n_expiries": 12,
    • "n_contracts": 5792,
    • "oi_usd": 32670143083.84,
    • "call_oi_usd": 18276964561.96,
    • "put_oi_usd": 14393178521.88,
    • "oi_coin": 457419.65,
    • "call_oi_coin": 255899.54,
    • "put_oi_coin": 201520.11,
    • "vol_usd_24h": 4295495191.7,
    • "call_vol_usd_24h": 2031780368.24,
    • "put_vol_usd_24h": 2263714823.46,
    • "vol_coin_24h": 60122.56,
    • "call_vol_coin_24h": 28436.77,
    • "put_vol_coin_24h": 31685.79,
    • "vol_premium_usd_24h": 34033631.12,
    • "pcr_oi": 0.7875,
    • "pcr_vol": 1.1143,
    • "atm_iv_30d": 37.2,
    • "expiries": [
      • { … 30 },
      • { … 30 }
      ],
    • "coverage": {
      • "included_exchanges": [ … 6 ],
      • "unavailable": [ … 2 ],
      • "stale_excluded": [],
      • "field_gaps": [ … 2 ],
      • "stale_included": [ … 2 ]
      },
    • "method": {
      • "oi_usd": "sum over contracts of oi_coin x that exchange's spot index price (USDT/USDC treated 1:1 as USD); oi_coin is open interest in units of the underlying coin after …",
      • "vol_usd_24h": "NOTIONAL 24h volume = sum of vol_coin (24h traded quantity in underlying coin) x the exchange's CURRENT spot index price; not premium turnover. Binance statisti…",
      • "vol_premium_usd_24h": "PREMIUM turnover (option price x quantity) as reported by the exchange: Deribit volume_usd, Binance amount, Gate sum(|size| x multiplier x price) from the 24h t…",
      • "pcr_oi": "put open interest / call open interest, both in underlying-coin units; null when call side is 0 or missing",
      • "pcr_vol": "put 24h volume / call 24h volume, both in underlying-coin units; null when call side is 0 or missing",
      • "max_pain": "per expiry: settlement price S among strikes with OI>0 minimizing pain_usd(S) = sum_calls oi_coin x max(S-K,0) + sum_puts oi_coin x max(K-S,0); ties take the lo…",
      • "atm_iv": "per exchange and expiry: reference price F = median of the exchange-published forward/underlying price of that expiry (the exchange index price where no forward…",
      • "atm_iv_30d": "30-day constant-maturity ATM IV: linear interpolation in days between the two expiries bracketing 30 days; null when 30 days is not bracketed",
      • "skew_25d": "IV(put with delta closest to -0.25, within +-0.10) - IV(call with delta closest to +0.25, within +-0.10), in percentage points, using exchange-published deltas …",
      • "expiry": "UTC date of the expiry timestamp (all integrated exchanges expire at 08:00 UTC); contracts from different exchanges with the same UTC expiry date are merged",
      • "oi_share_pct": "expiry oi_usd / total oi_usd of this response x 100"
      },
    • "meta": {
      • "schema": "coinboss.sd.options/1",
      • "source": [ … 2 ],
      • "observed_at": 1794522472654,
      • "received_at": 1794522473814,
      • "fetched_at": 1794542300391,
      • "window": "latest",
      • "quality": "STALE",
      • "is_stale": true,
      • "cache_ttl_s": 60,
      • "fallback": "on collector failure the last stored rows are served: an exchange whose newest batch is older than 25 min (collector cycle is 10 min) is excluded from totals (l…"
      }
    }

Doğrulanmış örnekler

Yoklama, yukarıdaki örneğin yanı sıra bu uç noktayı aşağıdaki parametrelerle de çağırır ve her seferinde şemayı kontrol eder.

ParametrelerHTTPYanıt süresiSonuç
coin=ETH&exchange=deribit20046 msBaşarılı STALE
coin=SOL20022 msBaşarılı STALE
coin=BTC&exchange=nope4001 msBaşarılı beklenen hatayı döndürür

Kontrol: 2026-11-13 03:58:20 UTC

Ayrıntılar

Kimlik doğrulama
Yok. Herkese açık uç nokta.
İstek sınırı
IP başına dakikada 1200 istek
Sunucu önbelleği
60s
Edge mikro önbelleği
10s
Güncelleme sıklığı
Toplayıcı turu 10 dakikada bir; bir borsa, son başarılı turundan sonra 25 dakika boyunca güncel sayılır.
Pencere
Vade sonu başına en güncel anlık görüntü; hacim alanları son 24 saati kapsar.
Veri kaynakları
Deribit, Binance, Bybit, OKX, Gate ve Coincall'un herkese açık REST opsiyon uç noktaları; CoinBoss tarafından toplanır ve saklanır (sd_opt_latest, sd_opt_summary_hourly). Hiçbir üçüncü taraf agregatör devrede değildir.
Borsa kapsamı
Altı opsiyon borsası. Seçilen borsalarda listelenmiş opsiyonu olmayan bir coin, null alanlarla, `meta.quality = "UNAVAILABLE"` değeriyle ve nedeni `coverage.unavailable` altında olacak şekilde HTTP 200 döndürür. Herkese açık opsiyon akışı olmayan borsalar da orada listelenir.
Sıralama
Vade sonu tarihi, artan.
Birimler
USD notional = contracts × contract size × spot index price of the venue. `*_coin` fields are in units of the underlying coin. Implied volatility is in percent (55 = 55 %). `vol_premium_usd_24h` is premium turnover, reported separately and never added to notional volume.
Yöntem
Contracts of different venues are grouped by UTC expiry date. Max pain and ATM IV are computed per expiry; `oi_share_pct` is the share of that expiry in the total open interest of the selection.
Zaman damgaları
Alan açıklamasında aksi belirtilmedikçe Unix epoch milisaniyesi (UTC)
Yanıt biçimi
json
Kararlılık
Kararlı
Kullanıma sunulma
2026-11-11

Canlı durum

AksamalıKontrol: 2026-11-13 03:58:20 UTCHTTP 20061 msŞema eşleşiyorEn yeni veri noktası 5.5h öncesine ait

Uç nokta veri kalitesini STALE olarak bildiriyor

Erişilebilirlik, son 30 gün

407 kontrolde başarı oranı: %100

Son yoklamanın saptadığı şema sapması
  • Dönüyor ama belgelenmemiş: coverage.stale_included, coverage.stale_included[], coverage.stale_included[].exchange, coverage.stale_included[].age_s

Hatalar

Başarısız çağrılar tüm uç noktalarda aynı yapıyı paylaşır. Tam liste hatalar sayfasındadır. Hatalar ve istek sınırları →

KodHTTPAnlamıNe yapmalı
INVALID_PARAM400Zorunlu bir parametre eksik ya da bir değer kabul edilmiyor. Biliniyorsa `param` parametrenin adını verir.Değiştirmeden yeniden denemeyin; isteği düzeltin.
UNAUTHORIZED401`CB-API-KEY` başlığı gönderildi, ancak anahtar bilinmiyor veya iptal edilmiş. Herkese açık veriler anahtar gerektirmez; başlığı kaldırın veya geçerli bir anahtar kullanın.Değiştirmeden yeniden denemeyin.
FORBIDDEN403Bu rota herkese açık API'nin parçası değildir (dahilî veya yalnızca hesaba özel).Yeniden denemeyin.
NOT_FOUND404Bilinmeyen rota ya da istenen coin / borsa / fon yok.Yeniden denemeyin; yolu ve tanımlayıcıları katalogla karşılaştırarak kontrol edin.
RATE_LIMITED429Dakika başına sınırdan fazla istek gönderildi. `Retry-After`, beklenecek saniye sayısını verir.`Retry-After` süresi kadar bekleyin, ardından artan beklemeyle yeniden deneyin.
INTERNAL500Beklenmeyen sunucu hatası. Mesaj bilinçli olarak geneldir; hatayı bildirirken `request_id` değerini belirtin.Birkaç saniye sonra bir kez yeniden deneyin; sorun sürerse istek kimliğiyle birlikte bildirin.
UPSTREAM_FAILED503Bu uç noktanın arkasındaki veri kaynağı zamanında yanıt vermedi. Yerine eskimiş veya ikame rakamlar döndürülmez.Artan beklemeyle yeniden deneyin; durum sayfasını kontrol edin.
UNAVAILABLE501 / 503Veri kümesi geçici olarak hazır değil (önbellek ısınıyor) ya da uç noktanın henüz yasal bir herkese açık kaynağı yok.Daha sonra yeniden deneyin; katalog, tasarım gereği mevcut olmayan uç noktaları işaretler.
REQUEST_FAILED200Bazı eski uç noktalar HTTP 200 ile `success: false` yanıtı verir. Yalnızca HTTP durumunu değil, her zaman `success` değerini de kontrol edin.Mesaja bağlıdır; başarısız bir istek olarak ele alın.

Deneyin

GET/api/sd/options/expiriesAksamalı
Parametreler

string — Coin symbol, case-insensitive (for example `BTC`). Missing or malformed values return 400.

string · varsayılan all — One venue, or `all` for the cross-venue aggregate.

İstek URL'sihttps://www.coinboss.com/api/sd/options/expiries?coin=BTC
Bir uç nokta seçip “İstek gönder” düğmesine basın. Yanıt, başlıklar ve süre bilgisi burada görünür.