Borsa bakiyesi geçmişi
Borsa bakiyesi geçmişi
/api/exchange-balances/historyİstek
Sorgu parametreleri
| Ad | Tür | Zorunlu | Varsayılan | İzin verilen değerler | Açıklama |
|---|---|---|---|---|---|
| symbol | string | İsteğe bağlı | BTC | BTC, ETH, USDT, USDC, SOL, XRP, DOGE, BNB, TRX, LTC, LINK, ADA, AVAX, SHIB, … (20) | Coin; desteklenmiyorsa 400. Örnek: BTC |
| exchange | string | İsteğe bağlı | all | — | Borsa kimliği; all = toplu. Örnek: all |
| days | integer | İsteğe bağlı | 365 | ≤ 1500 | Gün cinsinden geriye dönük pencere. Örnek: 365 |
Örnek istek
curl -s "https://www.coinboss.com/api/exchange-balances/history?symbol=BTC&exchange=all&days=365"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. |
| symbol | string | — | CoinBoss'un normalize ettiği biçimiyle enstrüman sembolü (örneğin BTCUSDT). |
| exchange | string | — | Borsa kimliği, küçük harfle (örneğin `binance`). |
| data | array | — | Veri yükü. |
| data[] | object | — | Veri yükü. |
| data[].d | string | — | Takvim tarihi (UTC). |
| data[].balance | number | — | Coin cinsinden bakiye. |
| data[].balance_usd | number | USD | Bakiye değeri. |
Üretilme zamanı: 2026-11-11 23:00 UTC; kaynak: 3 gerçek yanıt.
Örnek yanıt
/api/exchange-balances/history?symbol=BTC&exchange=all&days=365 · Gerçek yanıt, yakalanma zamanı: 2026-11-13 04:02:48 UTC. Uzun diziler ve eşlemeler görüntüleme için kısaltılmıştır: data: 365 öğe içeriyordu.
- "success"true
- "symbol""BTC"
- "exchange""all"
- "data"
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ç |
|---|---|---|---|
| days=365&symbol=ETH&exchange=all | 200 | 32 ms | Başarılı |
| days=365&symbol=SOL&exchange=all | 200 | 18 ms | Başarılı |
Kontrol: 2026-11-13 03:58:11 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ığı
- 6 saatte bir
- Pencere
- varsayılan olarak son 365 gün (`days` en çok 1500); veri 2022-11'de başlar
- Veri kaynakları
- Bir varlığın tek bir borsadaki veya tüm borsalardaki zincir üstü bakiyesinin günlük geçmişi; 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.
- Sıralama
- tarih, artan
- Birimler
- coins and USD
- Yöntem
- With `exchange` omitted or `all`, balances are summed across exchanges (alias tokens merged).
- 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/historyKullanılabilirstring · varsayılan BTC — Coin; 400 if unsupported.
string · varsayılan all — Exchange id; all = aggregate.
integer · varsayılan 365 · en çok 1500 — Look-back window in days.
https://www.coinboss.com/api/exchange-balances/history?symbol=BTC&exchange=all&days=365Bu 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