Borsa bakiyesi ayrıntısı
Borsa bakiyesi ayrıntısı (borsa sayfaları için)
/api/exchange-balances/exchange-detailİstek
Sorgu parametreleri
| Ad | Tür | Zorunlu | Varsayılan | İzin verilen değerler | Açıklama |
|---|---|---|---|---|---|
| ex | string | Zorunlu | — | — | Borsa kimliği; eksikse 400, bilinmiyorsa 404. Örnek: binance |
Örnek istek
curl -s "https://www.coinboss.com/api/exchange-balances/exchange-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. |
| exchange | object | — | Borsa kimliği, küçük harfle (örneğin `binance`). |
| exchange.ex | string | — | Borsa kimliği, küçük harfle. |
| exchange.name | string | — | Ad. |
| exchange.slug | string | — | URL'de güvenle kullanılabilen tanımlayıcı. |
| exchange.tvl_usd | number | USD | Kilitli toplam değer. |
| total_usd | number | USD | Toplam. |
| chg24h_pct | number | % | 24h yüzde değişim. |
| chg7d_pct | number | % | 7 günlük yüzde değişim. |
| chg30d_pct | number | % | 30 günlük yüzde değişim. |
| token_count | number | count | En güncel anlık görüntüde bu borsada izlenen bir cüzdan bakiyesi bulunan farklı token sayısı. |
| top_tokens | array | — | Borsanın USD değerine göre en büyük 30 token bakiyesi, en büyüğü başta. |
| top_tokens[] | object | — | Bir token: `symbol`, token cinsinden `balance`, `balance_usd` ve borsa toplamı içindeki `share_pct`. |
| top_tokens[].symbol | string | — | CoinBoss'un normalize ettiği biçimiyle enstrüman sembolü (örneğin BTCUSDT). |
| top_tokens[].balance | number | — | Coin cinsinden bakiye. |
| top_tokens[].balance_usd | number | USD | Bakiye değeri. |
| top_tokens[].share_pct | number | % | Toplam içindeki pay. |
| inflow_7d | array | — | Bakiyesinin USD değerindeki 7 günlük değişimi en yüksek olan en çok beş token (en büyük 40 varlık arasından); yükselen az sayıda token varsa negatif değerler içerebilir. |
| inflow_7d[] | object | — | Güncel bakiye değeri ve 7 günlük değişimiyle birlikte bir token. |
| inflow_7d[].symbol | string | — | CoinBoss'un normalize ettiği biçimiyle enstrüman sembolü (örneğin BTCUSDT). |
| inflow_7d[].balance_usd | number | USD | Bakiye değeri. |
| inflow_7d[].chg7d_usd | number | USD | Güncel `balance_usd` eksi yaklaşık 7 gün önceki günlük anlık görüntüdeki değeri; yalnızca net token akışını değil, fiyat hareketlerini de içerir. |
| inflow_7d[].chg7d_pct | number | % | 7 günlük yüzde değişim. |
| outflow_7d | array | — | Bakiyesinin USD değerindeki 7 günlük değişimi en negatif olan en çok beş token (en büyük 40 varlık arasından). |
| outflow_7d[] | object | — | Güncel bakiye değeri ve 7 günlük değişimiyle birlikte bir token. |
| outflow_7d[].symbol | string | — | CoinBoss'un normalize ettiği biçimiyle enstrüman sembolü (örneğin BTCUSDT). |
| outflow_7d[].balance_usd | number | USD | Bakiye değeri. |
| outflow_7d[].chg7d_usd | number | USD | Güncel `balance_usd` eksi yaklaşık 7 gün önceki günlük anlık görüntüdeki değeri (burada her zaman negatiftir); fiyat hareketlerini içerir. |
| outflow_7d[].chg7d_pct | number | % | 7 günlük yüzde değişim. |
| total_history | array | — | Borsanın izlenen toplam bakiyesinin günlük geçmişi; en çok son 400 gün, en eskisi başta. |
| total_history[] | object | — | Bir gün: `d` tarih (YYYY-MM-DD), `v` ise izlenen tüm token bakiyelerinin toplam USD değeridir. |
| total_history[].d | string | — | Takvim tarihi (UTC). |
| total_history[].v | number | — | Değer. |
Üretilme zamanı: 2026-11-11 23:00 UTC; kaynak: 2 gerçek yanıt.
Örnek yanıt
/api/exchange-balances/exchange-detail?ex=binance · Gerçek yanıt, yakalanma zamanı: 2026-11-13 04:02:47 UTC. Uzun diziler ve eşlemeler görüntüleme için kısaltılmıştır: inflow_7d: 5 öğe içeriyordu; outflow_7d: 5 öğe içeriyordu; top_tokens: 30 öğe içeriyordu; total_history: 400 öğe içeriyordu.
- "success"true
- "exchange"
- "ex""binance"
- "name""Binance"
- "slug""Binance-CEX"
- "tvl_usd"120908816738.32
- "total_usd"120908816738
- "chg24h_pct"12.726
- "chg7d_pct"6.777
- "chg30d_pct"-22.915
- "token_count"813
- "top_tokens"
- "inflow_7d"
- "outflow_7d"
- "total_history"
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 | 24 ms | Başarılı |
| — | 400 | 1 ms | Başarılı beklenen hatayı döndürür |
Kontrol: 2026-11-13 03:58: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
- 2m
- Edge mikro önbelleği
- 10s
- Güncelleme sıklığı
- 6 saatte bir
- Pencere
- en güncel anlık görüntü, 24h / 7d / 30d değişimleri ve 400 güne kadar günlük toplamlar
- Veri kaynakları
- Tek bir borsanın toplam zincir üstü varlıkları, başlıca token'ları ve son token akışları; herkese açık bir zincir üstü şeffaflık veri kümesinden alınır.
- Borsa kapsamı
- Cüzdan adreslerini yayımlayan yaklaşık 78 merkezî borsa (kaynak veri kümesinin izlediği biçimde); cüzdanlarını açıklamayan borsalar (ör. Coinbase, Upbit, Bithumb, Kraken) yer almaz. Günlük geçmiş 2022-11'de başlar. İlk 30 token döndürülür; geçmiş, izlenen 26 token ile sınırlıdır.
- Sıralama
- token'lar USD bakiyesine göre azalan; geçmiş tarihe göre artan
- Birimler
- USD; percent (changes)
- Yöntem
- Total = sum of token balances in USD; 7-day inflow/outflow lists rank tokens by change in balance over 7 days (top 5 each).
- 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
411 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/exchange-balances/exchange-detailKullanılabilirstring — Exchange id; 400 when missing, 404 if unknown.
https://www.coinboss.com/api/exchange-balances/exchange-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