Tek borsa için türev özeti
Tek borsa için türev özeti (OI, hacim, coin sayısı, ...)
/api/exchanges/detailİstek
Sorgu parametreleri
| Ad | Tür | Zorunlu | Varsayılan | İzin verilen değerler | Açıklama |
|---|---|---|---|---|---|
| ex | string | Zorunlu | — | — | 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.
| 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. |
| data | object | — | Veri yükü. |
| data.exchange | string | — | Borsa kimliği, küçük harfle (örneğin `binance`). |
| data.name | string | — | Ad. |
| data.volume_usd | number | USD | USD nominal değeri cinsinden hacim. |
| data.oi_usd | number | USD | USD nominal değeri cinsinden açık pozisyon. |
| data.liq_24h_long | number | — | 24h likide edilen long pozisyonlar. |
| data.liq_24h_short | number | — | 24h likide edilen short pozisyonlar. |
| data.liq_24h_total | number | — | 24h toplam likidasyon. |
| data.liq_24h_cnt | number | count | Borsada son 24 saatte kaydedilen likidasyon emri sayısı; borsanın likidasyon akışı yoksa null. |
| data.liq_source | boolean | — | 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.contracts | number | — | Sözleşme bazında satırlar. |
| data.options_vol_usd | null | USD | Borsanın opsiyon hacmi için ayrılmıştır; şu anda doldurulmadığından değer her zaman null'dur. |
| data.taker_fee | number | % | 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_fee | number | % | 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_dex | boolean | — | Merkeziyetsiz sürekli vadeli borsalar için true (örneğin Hyperliquid, dYdX, Aster), merkezî borsalar için false. |
| data.score | number | — | Puan. |
| data.has_ls | boolean | — | Bu borsa için long/short oranı verisi mevcutsa true. |
| data.total_assets_usd | number|null | USD | Borsanı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.reserve | object|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_usd | number | USD | Kilitli toplam değer. |
| data.reserve.clean_tvl_usd | number | USD | Üçü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_24h | number | USD | Üçüncü taraf kaynağın bildirdiği, son 24 saatte borsanın cüzdanlarına net giriş (negatif = net çıkış). |
| data.reserve.inflow_1w | number | USD | Üçüncü taraf kaynağın bildirdiği, son 7 günde borsanın cüzdanlarına net giriş (negatif = net çıkış). |
| data.reserve.inflow_1m | number | USD | Üçüncü taraf kaynağın bildirdiği, son bir ayda borsanın cüzdanlarına net giriş (negatif = net çıkış). |
| data.reserve.wallets_link | string | — | Borsanın kendi cüzdan veya rezerv kanıtı açıklamasının URL'si; bilinen bir açıklama yoksa null. |
| data.reserve.updated_at | number | ms | Bu satırın en son güncellendiği zaman. |
| data.dist_oi | array | — | 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[].coin | string | — | Coin sembolü, büyük harfle (örneğin BTC). |
| data.dist_oi[].v | number | — | Değer. |
| data.dist_vol | array | — | 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[].coin | string | — | Coin sembolü, büyük harfle (örneğin BTC). |
| data.dist_vol[].v | number | — | 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"
- "dist_oi"
- "dist_vol"
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ç |
|---|---|---|---|
| ex=okx | 200 | 164 ms | Başarılı |
| ex=hyperliquid | 200 | 179 ms | Başarılı |
| — | 400 | 1 ms | Baş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
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ı →
| 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/exchanges/detailKullanılabilirstring — Exchange id (lower-cased, a-z0-9. only); 400 when missing.
https://www.coinboss.com/api/exchanges/detail?ex=binanceBu kategoride daha fazlası
- Tek coin için borsaların zincir üstü bakiyeleri /api/exchange-balances
- Borsa bakiyesi ayrıntısı /api/exchange-balances/exchange-detail
- Tek borsa için coin bazında zincir üstü bakiyeler /api/exchange-balances/exchange/:ex
- Zincir üstü bakiye verisi olan borsalar /api/exchange-balances/exchanges-list
- Borsa bakiyesi geçmişi /api/exchange-balances/history
- Borsa bakiyesi listesi /api/exchange-balances/list
- Borsa bakiyelerinin desteklediği semboller /api/exchange-balances/symbols
- Tek borsa için türev özeti /api/exchanges/detail
- Tek borsa için türev piyasa listesi /api/exchanges/markets
- Tek borsada en çok hareket edenler /api/exchanges/movers
- Tek borsa için açık pozisyon geçmişi /api/exchanges/oi-history
- Türev borsa sıralaması /api/exchanges/ranking
- Ana sayfa borsa BTC bakiyesi özeti /api/home/exchange-btc-balances
- Borsa bazında hacim payı geçmişi /api/p3/volume/exchange-history
- Borsa rezervleri geçmişi /api/reserves/history
- Borsa rezervleri özeti /api/reserves/overview
- Borsa varlık şeffaflığı /api/transparency
- BTC hacminde borsa payları /api/volume/btc-ex-share
- Tek coinin hacminde borsa payları /api/volume/coin-ex-share
- Spot hacimde borsa payları /api/volume/spot-ex-share
- ABD ve offshore borsa hacmi karşılaştırması /api/volume/us-vs-offshore