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

Baza göre coin sıralaması

Borsalar arası medyan baza göre sıralanmış coinler; ortalama, OI ağırlıklı baz, açık pozisyon ve en düşük ile en yüksek değere sahip borsalarla birlikte.

GET/api/sd/basis/rank
Aksamalı. Uç nokta veri kalitesini STALE olarak bildiriyor

İstek

Sorgu parametreleri

AdTürZorunluVarsayılanİzin verilen değerlerAçıklama
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ı.
sortstringİsteğe bağlıbasis_descbasis_desc, basis_asc, abs_descSıralama anahtarı: medyan bazı en yüksek, en düşük veya mutlak değerce en büyük olan önce.
limitintegerİsteğe bağlı50≥ 1 · ≤ 200Satır sayısı.
min_exchangesintegerİsteğe bağlı3≥ 1 · ≤ 20Yalnızca en az bu sayıda borsada bazı bulunan coinler.

Örnek istek

curl -s "https://www.coinboss.com/api/sd/basis/rank"

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ı.
kindstring—`perp` veya `spot_perp`.
sortstring—Uygulanan sıralama düzeni.
limitnumber—Uygulanan satır sınırı.
min_exchangesnumber—Uygulanan minimum borsa sayısı.
totalnumber—`limit` uygulanmadan önce mevcut olan satırlar.
countnumber—Döndürülen satırlar.
dataarray—Coin başına bir satır.
data[]object—Coin başına bir satır.
data[].ranknumber—Sıralamadaki konum; satırın sıralanacak bir değeri yoksa `null`.
data[].coinstring—Coin sembolü (büyük harf).
data[].basis_pctnumber%Sürekli vadeli ve teslimatlı sözleşmeler için (mark − index) ÷ index × 100; sıralamalarda borsalar arası medyan.
data[].mean_pctnumber%Medyanla aynı küme üzerinden basit ortalama.
data[].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.
data[].oi_usdnumberUSDSözleşmenin tek taraflı açık pozisyonu; ağırlık olarak kullanılır.
data[].n_exchangesnumber—Toplu değerdeki borsalar.
data[].n_contractsnumber—Toplu değerdeki sözleşmeler.
data[].minobject—Bazı en düşük olan borsa ve sözleşme.
data[].min.exchangestring—Borsa kimliği (küçük harf).
data[].min.symbolstring—CoinBoss'un depolama biçimindeki sözleşme sembolü.
data[].min.basis_pctnumber%Sürekli vadeli ve teslimatlı sözleşmeler için (mark − index) ÷ index × 100; sıralamalarda borsalar arası medyan.
data[].maxobject—Bazı en yüksek olan borsa ve sözleşme.
data[].max.exchangestring—Borsa kimliği (küçük harf).
data[].max.symbolstring—CoinBoss'un depolama biçimindeki sözleşme sembolü.
data[].max.basis_pctnumber%Sürekli vadeli ve teslimatlı sözleşmeler için (mark − index) ÷ index × 100; sıralamalarda borsalar arası medyan.
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.basis_pctstring—`basis_pct` için formül notu, düz metin.
method.oi_weighted_pctstring—`oi_weighted_pct` için formül notu, düz metin.
method.inclusionstring—`inclusion` için formül notu, düz metin.
method.coinstring—`coin` 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üğü.
meta.collector_heartbeat_age_snumbersToplayıcının çalıştığını en son bildirmesinden bu yana geçen saniye.

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

Örnek yanıt

/api/sd/basis/rank · 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: coverage.stale_excluded: 21 öğe içeriyordu.

  • {
    • "success": true,
    • "schema": "coinboss.sd.basis/1",
    • "now": 1794542288498,
    • "kind": "perp",
    • "sort": "basis_desc",
    • "limit": 50,
    • "min_exchanges": 3,
    • "total": null,
    • "count": null,
    • "data": null,
    • "coverage": {
      • "included_exchanges": [],
      • "unavailable": [],
      • "stale_excluded": [ … 2 ]
      },
    • "method": {
      • "basis_pct": "median over exchanges (one primary contract per exchange) of the perpetual mark-vs-index basis, percent; the ranking key",
      • "oi_weighted_pct": "OI-weighted mean over all included contracts of the coin (single-sided OI, <= 3 h old); null when no contract has a weight",
      • "inclusion": "fresh rows only (<= 180 s); same row filters as /api/sd/basis; catalogued stock/ETF perpetuals (stock_contracts) are removed; coins quoted on fewer than min_exc…",
      • "coin": "multiplier contracts are folded into the underlying coin (1000PEPE, kPEPE -> PEPE)"
      },
    • "meta": {
      • "schema": "coinboss.sd.basis/1",
      • "source": [],
      • "observed_at": null,
      • "received_at": null,
      • "fetched_at": 1794542288498,
      • "window": "latest",
      • "quality": "STALE",
      • "is_stale": true,
      • "cache_ttl_s": 30,
      • "fallback": "only rows refreshed within 180 s are ranked; when the collector is down the list is empty and quality is STALE",
      • "collector_heartbeat_age_s": 3091
      }
    }

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ç
kind=spot_perp2002 msBaşarılı STALE
sort=basis_asc&limit=102002 msBaşarılı STALE
sort=zzz4002 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
30s
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
Sözleşme başına en güncel değer.
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; `limit` satır sayısını sınırlar (en çok 200).
Sıralama
`sort` ile belirlenir; sıralama anahtarı borsalar arası medyandır (`basis_pct`).
Birimler
All basis values in percent. Prices in the quote currency of the contract (USDT / USDC / USD). `oi_usd` single-sided.
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:08 UTCHTTP 20023 msŞema eşleşiyor

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_excluded[], coverage.stale_excluded[].exchange, coverage.stale_excluded[].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/basis/rankAksamalı
Parametreler

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 basis_desc — Sort key: highest, lowest or largest absolute median basis first.

integer · varsayılan 50 · en az 1 · en çok 200 — Number of rows.

integer · varsayılan 3 · en az 1 · en çok 20 — Only coins with a basis on at least this many exchanges.

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