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

Baz geçmişi (saatlik)

Tek coin için borsa bazında ve borsalar arası toplu değer (medyan, ortalama, OI ağırlıklı) olarak saatlik baz serisi.

GET/api/sd/basis/history
Kısmi kapsam. Toplama 2026-11-11'de başladı. Yanıt `history.available_from` değerini, `expected_hours` karşısında `n_hours` değerini ve `complete` değerini bildirir; verisi olmayan saatler yer almaz, enterpolasyonla doldurulmaz.

İ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
kindstringİsteğe bağlıperpperp, spot_perp`perp`: işaret fiyatının aynı borsanın endeks fiyatına göre farkı. `spot_perp`: sürekli vadeli fiyatının aynı borsanın spot fiyatına göre farkı.
rangestringİsteğe bağlı24h24h, 7d, 30dGeriye dönük aralık, saat başına bir nokta.
exchangestringİsteğe bağlı——Tek bir borsa kimliği. Varsayılan: tüm borsalar. Bilinmeyen bir kimlik 400 döndürür.

Örnek istek

curl -s "https://www.coinboss.com/api/sd/basis/history?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).
kindstring—`perp` veya `spot_perp`.
rangestring—Uygulanan geriye dönük aralık.
intervalstring—Seri noktaları arasındaki aralık.
exchangestring|null—Borsa kimliği (küçük harf).
aggregatearray—Bölümün borsalar arası toplu değeri.
aggregate[]object—Bölümün borsalar arası toplu değeri.
aggregate[].tnumbermsZaman diliminin başlangıcı.
aggregate[].median_pctnumber%Borsa başına bir ana sözleşme üzerinden medyan baz.
aggregate[].mean_pctnumber%Medyanla aynı küme üzerinden basit ortalama.
aggregate[].oi_weighted_pctnumber%Açık pozisyonla ağırlıklandırılmış baz; OI ağırlığı olmayan satırlar dışarıda bırakılır.
aggregate[].n_exchangesnumber—Toplu değerdeki borsalar.
seriesarray—Borsa başına bir seri.
series[]object—Borsa başına bir seri.
series[].exchangestring—Borsa kimliği (küçük harf).
series[].symbolstring—CoinBoss'un depolama biçimindeki sözleşme sembolü.
series[].primaryboolean—Medyan ve ortalamada borsasını temsil eden sözleşme için true.
series[].in_aggregateboolean—Satır dahil etme kurallarını geçtiyse true.
series[].pointsarray—`[hour start in ms, basis in %]` çiftleri, en eskiden başlayarak.
series[].points[]array—`[hour start in ms, basis in %]` çiftleri, en eskiden başlayarak.
series[].points[][]number—`[hour start in ms, basis in %]` çiftleri, en eskiden başlayarak.
historyobject—İstenen aralığın ne kadarının mevcut olduğu.
history.requested_fromnumbermsİstenen aralığın başlangıcı.
history.available_fromnumbermsSaklanan ilk saat.
history.available_tonumbermsSaklanan son saat.
history.n_hoursnumber—Aralıkta mevcut olan saat sayısı.
history.expected_hoursnumber—Aralığın eksiksiz olduğunda içerdiği saat sayısı.
history.completeboolean—İstenen aralığın her saati saklanıyorsa true.
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.series.pointsstring—`series.points` için formül notu, düz metin.
method.aggregate.median_pctstring—`aggregate.median_pct` için formül notu, düz metin.
method.aggregate.oi_weighted_pctstring—`aggregate.oi_weighted_pct` için formül notu, düz metin.
method.intervalstring—`interval` 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_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üğü.

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

Örnek yanıt

/api/sd/basis/history?coin=BTC · Gerçek yanıt, yakalanma zamanı: 2026-11-13 03:58:08 UTC. Uzun diziler ve eşlemeler görüntüleme için kısaltılmıştır: series: 20 öğe içeriyordu; aggregate: 25 öğe içeriyordu; meta.source: 20 öğe içeriyordu; series[].points: 25 öğe içeriyordu; coverage.included_exchanges: 20 öğe içeriyordu.

  • {
    • "success": true,
    • "schema": "coinboss.sd.basis/1",
    • "now": 1794542288014,
    • "coin": "BTC",
    • "kind": "perp",
    • "range": "24h",
    • "interval": "1h",
    • "exchange": null,
    • "aggregate": [
      • { … 5 },
      • { … 5 }
      ],
    • "series": [
      • { … 5 },
      • { … 5 }
      ],
    • "history": {
      • "requested_from": 1794452400000,
      • "available_from": 1794452400000,
      • "available_to": 1794538800000,
      • "n_hours": 25,
      • "expected_hours": 24,
      • "complete": true
      },
    • "coverage": {
      • "included_exchanges": [ … 8 ],
      • "unavailable": [ … 2 ],
      • "stale_excluded": []
      },
    • "method": {
      • "series.points": "[hour_ts, (mark_price - index_price) / index_price * 100] from the first collector round after each full hour; hours where the two timestamps were more than 60 …",
      • "aggregate.median_pct": "median over one primary contract per exchange in that hour; excluded: |value| > 10, contracts with no trade in 24 h, exchanges whose index is not a comparable i…",
      • "aggregate.oi_weighted_pct": "sum(value * oi_usd) / sum(oi_usd) over all included contracts that have an OI snapshot for the same hour (oi_history / sd_contract_hourly, single-sided); null w…",
      • "interval": "fixed 1 h buckets, no interpolation; missing hours are simply absent"
      },
    • "meta": {
      • "schema": "coinboss.sd.basis/1",
      • "source": [ … 2 ],
      • "observed_at": null,
      • "received_at": 1794538827406,
      • "fetched_at": 1794542288014,
      • "window": "24h",
      • "quality": "FRESH",
      • "is_stale": false,
      • "cache_ttl_s": 300,
      • "fallback": "history is served as stored; hours without a snapshot are absent, never interpolated"
      }
    }

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&kind=spot_perp20041 msBaşarılı FRESH
coin=BTC&exchange=binance20032 msBaşarılı FRESH
coin=BTC&range=1y4001 msBaşarılı beklenen hatayı döndürür

Kontrol: 2026-11-13 03:58:08 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ığı
Toplayıcı turu 60 saniyede bir; bir satır 180 saniye boyunca güncel sayılır. Geçmiş, saatlik anlık görüntülerden beslenir.
Pencere
24h / 7d / 30d, saatlik dilimler.
Veri kaynakları
21 türev borsasının yayımladığı işaret fiyatı, endeks fiyatı ve son fiyat ile aynı borsanın spot fiyatı; CoinBoss tarafından toplanır ve saklanır (sd_px_latest, sd_px_hourly).
Borsa kapsamı
21 borsa. Endeks fiyatı veya işaret fiyatı yayımlamayan borsalar `coverage.unavailable` altında listelenir; iki fiyat bacağı arasında 60 saniyeden fazla fark olan satırlar `null` döndürür. Toplu değerin dışında bırakılan satırlar, nedeniyle birlikte `coverage.excluded_from_aggregate` altında listelenir.
Sayfalama
Sayfalama yok; `range` nokta sayısını sınırlar.
Sıralama
Zaman, artan.
Birimler
All basis values in percent. Prices in the quote currency of the contract (USDT / USDC / USD). `oi_usd` single-sided.
Yöntem
Each point is the snapshot taken in the first ten minutes of the hour. The OI weight of a historical hour is the open interest recorded in that hour; without it `oi_weighted_pct` is `null`.
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

KısmiKontrol: 2026-11-13 03:58:08 UTCHTTP 20045 msŞema eşleşiyorEn yeni veri noktası 58m öncesine ait

Toplama 2026-11-11'de başladı. Yanıt `history.available_from` değerini, `expected_hours` karşısında `n_hours` değerini ve `complete` değerini bildirir; verisi olmayan saatler yer almaz, enterpolasyonla doldurulmaz.

Erişilebilirlik, son 30 gün

407 kontrolde başarı oranı: %100

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/basis/historyKısmi
Parametreler

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

string · varsayılan perp — `perp`: mark price against the index price of the same exchange. `spot_perp`: perpetual price against the spot price of the same exchange.

string · varsayılan 24h — Look-back range, one point per hour.

string — One exchange id. Default: all exchanges. An unknown id returns 400.

İstek URL'sihttps://www.coinboss.com/api/sd/basis/history?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.