/api/exchanges/detail
GETKullanılabilir

Tek borsa için türev özeti

Tek borsa için türev özeti (OI, hacim, coin sayısı, ...)

GET/api/exchanges/detail

İstek

Sorgu parametreleri

AdTürZorunluVarsayılanİzin verilen değerlerAçıklama
exstringZorunlu——Borsa kimliği (küçük harfe çevrilir, yalnızca a-z0-9.); eksikse 400. Örnek: binance

Örnek istek

curl -s "https://www.coinboss.com/api/exchanges/detail?ex=binance"

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.
dataobject—Veri yükü.
data.exchangestring—Borsa kimliği, küçük harfle (örneğin `binance`).
data.namestring—Ad.
data.volume_usdnumberUSDUSD nominal değeri cinsinden hacim.
data.oi_usdnumberUSDUSD nominal değeri cinsinden açık pozisyon.
data.liq_24h_longnumber—24h likide edilen long pozisyonlar.
data.liq_24h_shortnumber—24h likide edilen short pozisyonlar.
data.liq_24h_totalnumber—24h toplam likidasyon.
data.liq_24h_cntnumbercountBorsada son 24 saatte kaydedilen likidasyon emri sayısı; borsanın likidasyon akışı yoksa null.
data.liq_sourceboolean—Bu borsa için son 7 günde likidasyon kaydı varsa true; false olduğunda `liq_24h_*` alanları sıfır değil, null olur.
data.contractsnumber—Sözleşme bazında satırlar.
data.options_vol_usdnullUSDBorsanın opsiyon hacmi için ayrılmıştır; şu anda doldurulmadığından değer her zaman null'dur.
data.taker_feenumber%Borsanın herkese açık ücret tarifesinden alınan, USDT sürekli vadeli sözleşmeler için temel kademe taker ücreti (0.05 = %0,05); statik referans değerdir, bilinmiyorsa null.
data.maker_feenumber%Borsanın herkese açık ücret tarifesinden alınan, USDT sürekli vadeli sözleşmeler için temel kademe maker ücreti (0.02 = %0,02); statik referans değerdir, bilinmiyorsa null.
data.is_dexboolean—Merkeziyetsiz sürekli vadeli borsalar için true (örneğin Hyperliquid, dYdX, Aster), merkezî borsalar için false.
data.scorenumber—Puan.
data.has_lsboolean—Bu borsa için long/short oranı verisi mevcutsa true.
data.total_assets_usdnumber|nullUSDBorsanın açıkladığı cüzdanlarda tutulan toplam varlıklar (`reserve.tvl_usd` ile aynı değer); üçüncü taraf bir kaynaktan alınır. Kapsanmıyorsa null.
data.reserveobject|null—Borsanın açıkladığı cüzdanların üçüncü taraf bir kaynaktan alınan rezerv anlık görüntüsü; yaklaşık 6 saatte bir yenilenir. Borsa kapsanmıyorsa null.
data.reserve.tvl_usdnumberUSDKilitli toplam değer.
data.reserve.clean_tvl_usdnumberUSDÜçüncü taraf kaynağın tanımladığı biçimde, borsanın kendi platform token'ı hariç cüzdan varlıkları; yayımlanmıyorsa null.
data.reserve.inflow_24hnumberUSDÜçüncü taraf kaynağın bildirdiği, son 24 saatte borsanın cüzdanlarına net giriş (negatif = net çıkış).
data.reserve.inflow_1wnumberUSDÜçüncü taraf kaynağın bildirdiği, son 7 günde borsanın cüzdanlarına net giriş (negatif = net çıkış).
data.reserve.inflow_1mnumberUSDÜçüncü taraf kaynağın bildirdiği, son bir ayda borsanın cüzdanlarına net giriş (negatif = net çıkış).
data.reserve.wallets_linkstring—Borsanın kendi cüzdan veya rezerv kanıtı açıklamasının URL'si; bilinen bir açıklama yoksa null.
data.reserve.updated_atnumbermsBu satırın en son güncellendiği zaman.
data.dist_oiarray—Bu borsada açık pozisyona göre ilk 20 coin, en büyüğü başta; yakın zamanda güncellenmemiş sözleşmeler hariç tutulur.
data.dist_oi[]object—Bir coin: `coin` temel varlık, `v` ise bu borsadaki USD cinsinden açık pozisyonudur.
data.dist_oi[].coinstring—Coin sembolü, büyük harfle (örneğin BTC).
data.dist_oi[].vnumber—Değer.
data.dist_volarray—Bu borsada 24 saatlik vadeli hacme göre ilk 20 coin, en büyüğü başta; son 1 saat içinde güncellenmemiş ticker'lar hariç tutulur.
data.dist_vol[]object—Bir coin: `coin` temel varlık, `v` ise bu borsadaki USD cinsinden 24 saatlik hacmidir.
data.dist_vol[].coinstring—Coin sembolü, büyük harfle (örneğin BTC).
data.dist_vol[].vnumber—Değer.

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

Örnek yanıt

/api/exchanges/detail?ex=binance · Gerçek yanıt, yakalanma zamanı: 2026-11-13 03:52:50 UTC. Uzun diziler ve eşlemeler görüntüleme için kısaltılmıştır: data.dist_oi: 20 öğe içeriyordu; data.dist_vol: 20 öğe içeriyordu.

  • {
    • "success": true,
    • "data": {
      • "exchange": "binance",
      • "name": "Binance",
      • "volume_usd": 65939302653.96,
      • "oi_usd": 24379577678.85,
      • "liq_24h_long": 417516080.56,
      • "liq_24h_short": 15925112.83,
      • "liq_24h_total": 433441193.39,
      • "liq_24h_cnt": 45872,
      • "liq_source": true,
      • "contracts": 762,
      • "options_vol_usd": null,
      • "taker_fee": 0.05,
      • "maker_fee": 0.02,
      • "is_dex": false,
      • "score": 96,
      • "has_ls": true,
      • "total_assets_usd": 121135381605.44,
      • "reserve": { … 7 },
      • "dist_oi": [ … 2 ],
      • "dist_vol": [ … 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ç
ex=okx200164 msBaşarılı
ex=hyperliquid200179 msBaşarılı
—4001 msBaşarılı beklenen hatayı döndürür

Kontrol: 2026-11-13 03:28:10 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ığı
ticker'lar dakikada bir; OI 5 dakikada bir; rezervler 6 saatte bir; bellek içi önbellek 30 s
Pencere
kayan 24h hacim ve likidasyonlar
Veri kaynakları
Borsanın herkese açık API'sinden (hacim, OI, sözleşmeler), likidasyon akışlarından ve üçüncü taraf kaynağın CEX rezerv verilerinden derlenen borsa bazında profil.
Borsa kapsamı
Verisi toplanan herhangi bir türev borsası; rezervler yalnızca üçüncü taraf bir kaynaktan izlenen 10 borsa için
Sayfalama
yok
Birimler
USD; score 1-99
Yöntem
score = clamp(1..99, round(log10(vol + 10) / 11.2 * 70 + log10(oi + 10) / 11 * 30))
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:50 UTCHTTP 200177 msŞema eşleşiyorEn yeni veri noktası 4.7h öncesine ait

Erişilebilirlik, son 30 gün

409 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/exchanges/detailKullanılabilir
Parametreler

string — Exchange id (lower-cased, a-z0-9. only); 400 when missing.

İstek URL'sihttps://www.coinboss.com/api/exchanges/detail?ex=binance
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.