/api/options/iv
GETKullanılabilir

Opsiyon zımni volatilite gülümsemesi / vade yapısı

Opsiyon zımni volatilite gülümsemesi / vade yapısı

GET/api/options/iv
Tek borsa: yalnızca Deribit'in herkese açık opsiyon verilerinden hesaplanır. `volume_usd` türündeki alanlar, borsanın prim işlem hacmi bildirdiği yerlerde prim bazlıdır. Borsa bazında kapsamıyla altı borsa için `/api/sd/options/overview` uç noktasını kullanın.

İstek

Sorgu parametreleri

AdTürZorunluVarsayılanİzin verilen değerlerAçıklama
currencystringİsteğe bağlıBTCBTC, ETHDayanak varlık: `BTC` veya `ETH`. Başka herhangi bir değer 400 `INVALID_PARAM` döndürür. Takma ad: `coin`. Örnek: BTC
expirystringİsteğe bağlı——Vade sonu; eksik veya geçersizse varsayılan vade sonu.

Örnek istek

curl -s "https://www.coinboss.com/api/options/iv?currency=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.
currencystring—Para birimi / varlık sembolü.
index_pricenumber—Dayanak varlığın endeks fiyatı.
termarray—En güncel Deribit opsiyon anlık görüntüsünden üretilen zımni volatilite vade yapısı: vadesi dolmamış her vade sonu için bir kayıt, en yakını başta.
term[]object—Bir vade sonu: `expiry` tarihi, `atm_iv`, `total_oi` (USD cinsinden nominal açık pozisyon) ve `strikes` sayısı.
term[].expirystring—Opsiyon serisinin vade sonu tarihi.
term[].atm_ivnumber%Vade sonunun başa baş (at-the-money) zımni volatilitesi: endeks fiyatına en yakın kullanım fiyatındaki call ve put'un Deribit işaret IV'lerinin ortalaması (yıllıklandırılmış, 37.5 = %37,5).
term[].total_oinumber—Toplam açık pozisyon.
term[].strikesnumber—Opsiyon kullanım fiyatları.
smileobject—Tek bir vade sonunun volatilite gülümsemesi: istenen `expiry` ya da varsayılan olarak açık pozisyonu en büyük olan vade sonu; veri yoksa null.
smile.expirystring—Opsiyon serisinin vade sonu tarihi.
smile.pointsarray—Veri noktaları.
smile.points[]object—Veri noktaları.
smile.points[].strikenumberUSDKullanım fiyatı.
smile.points[].call_ivnumber%Bu kullanım fiyatındaki call'un Deribit işaret zımni volatilitesi (yıllıklandırılmış, 37.5 = %37,5); call'un işaret IV'si yoksa null.
smile.points[].put_ivnumber%Bu kullanım fiyatındaki put'un Deribit işaret zımni volatilitesi (yıllıklandırılmış, 37.5 = %37,5); put'un işaret IV'si yoksa null.

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

Örnek yanıt

/api/options/iv?currency=BTC · Gerçek yanıt, yakalanma zamanı: 2026-11-13 03:52:56 UTC. Uzun diziler ve eşlemeler görüntüleme için kısaltılmıştır: term: 12 öğe içeriyordu; smile.points: 60 öğe içeriyordu.

  • {
    • "success": true,
    • "currency": "BTC",
    • "index_price": 69009.96,
    • "term": [
      • { … 4 },
      • { … 4 }
      ],
    • "smile": {
      • "expiry": "2026-12-25",
      • "points": [ … 2 ]
      }
    }

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ç
currency=ETH2002 msBaşarılı
currency=SOL4001 msBaşarılı beklenen hatayı döndürür

Kontrol: 2026-11-13 03:28: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
5m
Edge mikro önbelleği
10s
Güncelleme sıklığı
10 dakikada bir (anlık görüntü tümüyle değiştirilir)
Pencere
en güncel anlık görüntü
Veri kaynakları
Tek bir borsanın (Deribit) işaret IV'sinden üretilen zımni volatilite vade yapısı ve gülümsemesi.
Borsa kapsamı
Yalnızca Deribit, BTC ve ETH opsiyonları; diğer borsalar (Binance/OKX/Bybit opsiyonları, CME) dahil değildir. Yalnızca gelecekteki vade sonları.
Sıralama
vade sonu, artan; kullanım fiyatları, artan
Birimler
percent (annualized implied volatility); USD notional (open interest)
Yöntem
ATM IV per expiry = mean of call and put mark IV at the strike closest to the index price; smile lists call/put mark IV per strike for one expiry.
Zaman damgaları
Alan açıklamasında aksi belirtilmedikçe Unix epoch milisaniyesi (UTC)
Yanıt biçimi
json
Kararlılık
Kararlı

Canlı durum

KullanılabilirKontrol: 2026-11-13 03:52:56 UTCHTTP 2003 msŞema eşleşiyor

Erişilebilirlik, son 30 gün

409 kontrolde başarı oranı: %99.76

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/options/ivKullanılabilir
Parametreler

string · varsayılan BTC — Underlying: `BTC` or `ETH`. Any other value returns 400 `INVALID_PARAM`. Alias: `coin`.

string — Expiry; default expiry when missing or invalid.

İstek URL'sihttps://www.coinboss.com/api/options/iv?currency=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.