Opsiyon zımni volatilite gülümsemesi / vade yapısı
Opsiyon zımni volatilite gülümsemesi / vade yapısı
/api/options/ivİstek
Sorgu parametreleri
| Ad | Tür | Zorunlu | Varsayılan | İzin verilen değerler | Açıklama |
|---|---|---|---|---|---|
| currency | string | İsteğe bağlı | BTC | BTC, ETH | Dayanak varlık: `BTC` veya `ETH`. Başka herhangi bir değer 400 `INVALID_PARAM` döndürür. Takma ad: `coin`. Örnek: BTC |
| expiry | string | İ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.
| Alan | Tür | Birim | Açıklama |
|---|---|---|---|
| success | boolean | — | İstek başarılıysa true. Başarısızlık durumunda gövde `{ success: false, code, error, request_id }` olur. |
| currency | string | — | Para birimi / varlık sembolü. |
| index_price | number | — | Dayanak varlığın endeks fiyatı. |
| term | array | — | 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[].expiry | string | — | Opsiyon serisinin vade sonu tarihi. |
| term[].atm_iv | number | % | 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_oi | number | — | Toplam açık pozisyon. |
| term[].strikes | number | — | Opsiyon kullanım fiyatları. |
| smile | object | — | 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.expiry | string | — | Opsiyon serisinin vade sonu tarihi. |
| smile.points | array | — | Veri noktaları. |
| smile.points[] | object | — | Veri noktaları. |
| smile.points[].strike | number | USD | Kullanım fiyatı. |
| smile.points[].call_iv | number | % | 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_iv | number | % | 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"
- "smile"
- "expiry""2026-12-25"
- "points"
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.
| Parametreler | HTTP | Yanıt süresi | Sonuç |
|---|---|---|---|
| currency=ETH | 200 | 2 ms | Başarılı |
| currency=SOL | 400 | 1 ms | Baş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
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ı →
| Kod | HTTP | Anlamı | Ne yapmalı |
|---|---|---|---|
| INVALID_PARAM | 400 | Zorunlu 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. |
| UNAUTHORIZED | 401 | `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. |
| FORBIDDEN | 403 | Bu rota herkese açık API'nin parçası değildir (dahilî veya yalnızca hesaba özel). | Yeniden denemeyin. |
| NOT_FOUND | 404 | Bilinmeyen rota ya da istenen coin / borsa / fon yok. | Yeniden denemeyin; yolu ve tanımlayıcıları katalogla karşılaştırarak kontrol edin. |
| RATE_LIMITED | 429 | Dakika 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. |
| INTERNAL | 500 | Beklenmeyen 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_FAILED | 503 | Bu 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. |
| UNAVAILABLE | 501 / 503 | Veri 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_FAILED | 200 | Bazı 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
/api/options/ivKullanılabilirstring · varsayılan BTC — Underlying: `BTC` or `ETH`. Any other value returns 400 `INVALID_PARAM`. Alias: `coin`.
string — Expiry; default expiry when missing or invalid.
https://www.coinboss.com/api/options/iv?currency=BTCBu kategoride daha fazlası
- Opsiyon zinciri (tek borsa) /api/sd/options/chain
- Vade sonuna göre opsiyonlar /api/sd/options/expiries
- Opsiyon geçmişi (saatlik) /api/sd/options/history
- Opsiyon özeti (tüm borsalar) /api/sd/options/overview
- Kullanım fiyatına göre opsiyonlar /api/sd/options/strikes
- Coin sayfası opsiyon özeti /api/currency/options-summary
- Opsiyon zımni volatilite gülümsemesi / vade yapısı /api/options/iv
- Opsiyon zımni volatilite geçmişi /api/options/iv-history
- Opsiyon maksimum acı /api/options/max-pain
- Vade sonuna göre opsiyon OI /api/options/oi-by-expiry
- Kullanım fiyatına göre opsiyon OI /api/options/oi-by-strike
- Opsiyon özeti /api/options/overview
- Opsiyon hacim dağılımı /api/options/volume-dist