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

Opsiyon geçmişi (saatlik)

Tek coin için opsiyon açık pozisyonunun, hacminin, put/call oranının, ATM IV değerinin veya maksimum acının saatlik serisi. Geçmiş, CoinBoss'un veri toplamaya başladığı tarihte (2026-11-11) başlar; daha önceki saatler geriye dönük doldurulmaz.

GET/api/sd/options/history
Kısmi kapsam. Bu serinin toplanması 2026-11-11'de başladı. İstenen aralık dolana kadar yanıt mevcut noktaları döndürür, `expected_points` karşısında `points_count` değerini bildirir ve `meta.quality = "PARTIAL"` olarak işaretler. Eksik saatler enterpolasyonla doldurulmaz.
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
metricstringZorunlu—oi, volume, pcr, atm_iv, max_painDöndürülecek seri. Örnek: oi
rangestringİsteğe bağlı7d24h, 7d, 30d, 90dGeriye dönük aralık; saat başına bir nokta, en çok 2160 nokta.
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/history?coin=BTC&metric=oi"

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).
metricstring—`metric` parametresiyle seçilen seri.
rangestring—Uygulanan geriye dönük aralık.
intervalstring—Seri noktaları arasındaki aralık.
points_countnumber—Döndürülen nokta sayısı.
expected_pointsnumber—İstenen aralığın eksiksiz olduğunda içereceği saatlik nokta sayısı.
history_started_atnumbermsCoinBoss'un topladığı ilk saatin zamanı.
first_tnumbermsDöndürülen ilk noktanın zamanı.
last_tnumbermsDöndürülen son noktanın zamanı.
pointsarray—Seri noktaları, en eskiden başlayarak.
points[]object—Seri noktaları, en eskiden başlayarak.
points[].tnumbermsZaman diliminin başlangıcı.
points[].snapshot_atnumbermsNoktanın yazıldığı toplayıcı turunun zamanı.
points[].n_exchangesnumber—Noktadaki borsa sayısı.
points[].exchangesarray—Bu satıra dahil edilen borsalar.
points[].exchanges[]string—Bu satıra dahil edilen borsalar.
points[].oi_usdnumberUSDUSD nominal değeri olarak açık pozisyon: coin miktarı × spot endeks fiyatı. Tek taraflı. bulunmayabilir
points[].call_oi_usdnumberUSDCall açık pozisyonu, USD nominal değeri. bulunmayabilir
points[].put_oi_usdnumberUSDPut açık pozisyonu, USD nominal değeri. bulunmayabilir
points[].oi_coinnumbercoinDayanak coin birimi cinsinden açık pozisyon. bulunmayabilir
points[].index_pricenumberUSDUSD'ye çevirmede kullanılan spot endeks fiyatı (toplu değerlerde borsaların kendi endeks fiyatlarının medyanı). bulunmayabilir
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ş
methodobject—Bu yanıtta kullanılan formüllerin düz metin açıklaması; alan başına bir girdi.
method.pointsstring—`points` için formül notu, düz metin.
method.exchangesstring—`exchanges` için formül notu, düz metin.
method.history_depthstring—`history_depth` için formül notu, düz metin.
method.oi_usdstring—`oi_usd` için formül notu, düz metin. bulunmayabilir
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_atnull—Kaynağı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üğü.
points[].pcr_oinumberratioPut açık pozisyonu ÷ call açık pozisyonu, coin birimi cinsinden; call tarafı 0 ise `null`. bulunmayabilir
points[].pcr_volnumberratioPut 24h hacmi ÷ call 24h hacmi, coin birimi cinsinden; call tarafı 0 ise `null`. bulunmayabilir
method.pcr_oistring—`pcr_oi` için formül notu, düz metin. bulunmayabilir
method.pcr_volstring—`pcr_vol` için formül notu, düz metin. bulunmayabilir
points[].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`. bulunmayabilir
method.atm_ivstring—`atm_iv` için formül notu, düz metin. bulunmayabilir
method.atm_iv_30dstring—`atm_iv_30d` için formül notu, düz metin. bulunmayabilir

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

Örnek yanıt

/api/sd/options/history?coin=BTC&metric=oi · 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: points: 23 öğe içeriyordu; meta.source: 6 öğe içeriyordu; coverage.unavailable: 12 öğe içeriyordu.

  • {
    • "success": true,
    • "schema": "coinboss.sd.options/1",
    • "now": 1794542300888,
    • "coin": "BTC",
    • "exchange": "all",
    • "metric": "oi",
    • "range": "7d",
    • "interval": "1h",
    • "points_count": 23,
    • "expected_points": 168,
    • "history_started_at": 1794416400000,
    • "first_t": 1794416400000,
    • "last_t": 1794520800000,
    • "points": [
      • { … 9 },
      • { … 9 }
      ],
    • "coverage": {
      • "included_exchanges": [ … 6 ],
      • "unavailable": [ … 2 ],
      • "stale_excluded": []
      },
    • "method": {
      • "points": "one point per UTC hour bucket (t = bucket start, ms); the value is the LAST collector snapshot inside that hour (snapshot_at); hours in which the collector prod…",
      • "exchanges": "exchanges that were fresh and therefore included in that hour's figure; a change in this list between points explains level shifts in the all-exchange series",
      • "history_depth": "hourly summaries are kept for 90 days; the series starts when the collector was first deployed (history_started_at), so fewer points than the requested range ma…",
      • "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 …"
      },
    • "meta": {
      • "schema": "coinboss.sd.options/1",
      • "source": [ … 2 ],
      • "observed_at": null,
      • "received_at": 1794522484809,
      • "fetched_at": 1794542300888,
      • "window": "7d",
      • "quality": "STALE",
      • "is_stale": true,
      • "cache_ttl_s": 300,
      • "fallback": "hours without a collector snapshot are absent from the series (no interpolation); PARTIAL means fewer hourly points exist than the requested range (history shor…"
      }
    }

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&range=24h&metric=pcr2002 msBaşarılı STALE
coin=BTC&metric=atm_iv2003 msBaşarılı STALE
coin=BTC4001 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
5m
Edge mikro önbelleği
10s
Güncelleme sıklığı
Saat başına bir nokta; o saatin son toplayıcı turundan yazılır.
Pencere
24h / 7d / 30d / 90d, saatlik noktalar.
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.
Sayfalama
Sayfalama yok; `range` nokta sayısını sınırlar.
Sıralama
Zaman, 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.
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 2002 msŞema eşleşiyorEn yeni veri noktası 6h öncesine ait

Uç nokta veri kalitesini STALE olarak bildiriyor

Erişilebilirlik, son 30 gün

407 kontrolde başarı oranı: %99.75

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/historyAksamalı
Parametreler

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

string — Series to return.

string · varsayılan 7d — Look-back range; one point per hour, 2160 points at most.

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

İstek URL'sihttps://www.coinboss.com/api/sd/options/history?coin=BTC&metric=oi
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.