GETKullanılabilirBeta
Araştırma sayfası istatistikleri
Araştırma sayfası istatistikleri (likidasyon / türevler / Hyperliquid / ETF / TradFi)
GET
/api/research/stats`avg_funding_rate_pct` bir yüzdedir (0.0021, %0,0021 anlamına gelir). Toplamlar yalnızca hâlâ güncellenen satırları sayar.
İstek
Sorgu parametreleri
| Ad | Tür | Zorunlu | Varsayılan | İzin verilen değerler | Açıklama |
|---|---|---|---|---|---|
| topic | string | Zorunlu | — | liquidation, derivatives, hyperliquid, etf, tradfi | Konu; bilinmiyorsa 400. Örnek: liquidation |
Örnek istek
curl -s "https://www.coinboss.com/api/research/stats?topic=liquidation"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.topic | string | — | İstatistiklerin ait olduğu konu; `topic` parametresi yinelenir. |
| data.generated_at | string | — | Tarih-saat dizesi. |
| data.stats | object | — | Konunun istatistikleri; alan kümesi konuya göre değişir. |
| data.stats.total_liquidated_365d_usd | number | USD | Günlük toplu değerlerden alınan, son 365 günde kaydedilen likidasyonların toplam değeri. |
| data.stats.total_events_365d | number | count | Son 365 günde kaydedilen likidasyon emri sayısı. |
| data.stats.total_liquidated_30d_usd | number | USD | Son 30 günde kaydedilen likidasyonların toplam değeri. |
| data.stats.long_share_30d_pct | number | % | Son 30 günde long likidasyonlar ÷ (long + short likidasyonlar) × 100. |
| data.stats.worst_day_365d | object | — | Son 365 günde likidasyon toplamı en büyük olan UTC günü: `date` ve `total_usd`. |
| data.stats.worst_day_365d.date | string | — | Takvim tarihi (UTC). |
| data.stats.worst_day_365d.total_usd | number | USD | Toplam. |
| data.stats.largest_single_30d | object | — | Son 30 günün en büyük tek likidasyon emri: `symbol`, `exchange` ve `value_usd`. |
| data.stats.largest_single_30d.symbol | string | — | CoinBoss'un normalize ettiği biçimiyle enstrüman sembolü (örneğin BTCUSDT). |
| data.stats.largest_single_30d.exchange | string | — | Borsa kimliği, küçük harfle (örneğin `binance`). |
| data.stats.largest_single_30d.value_usd | number | USD | Değer. |
| data.stats.coins_tracked_30d | number | count | Son 30 günde en az bir likidasyonu olan farklı coin sayısı. |
| cached | boolean | — | Yanıt 1 saatlik önbellekten sunulduysa bulunur ve true değerindedir; yeni hesaplandıysa bulunmaz. |
Üretilme zamanı: 2026-11-11 23:01 UTC; kaynak: 1 gerçek yanıt.
Örnek yanıt
/api/research/stats?topic=liquidation · Gerçek yanıt, yakalanma zamanı: 2026-11-13 03:53:49 UTC.
- "success"true
- "data"
- "topic""liquidation"
- "generated_at""2026-11-13T03:45:01.925Z"
- "stats"
- "cached"true
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
- 60m
- Edge mikro önbelleği
- 10s
- Güncelleme sıklığı
- konu başına 1 saatlik bellek içi önbellek
- Pencere
- liquidation: 365d / 30d; derivatives: en güncel ve 24h; tradfi: 30d ve tüm zamanlar; etf: 2024-01-11'den itibaren
- Veri kaynakları
- Kendi veritabanımızdan toplanan konu bazında öne çıkan istatistikler (liquidation, derivatives, hyperliquid, etf, tradfi); ETF rakamları üçüncü taraf bir kaynağın akış tablolarından gelir.
- Borsa kapsamı
- topic = liquidation | derivatives | hyperliquid | etf | tradfi
- Sayfalama
- yok
- Birimler
- USD; percentages
- Zaman damgaları
- Alan açıklamasında aksi belirtilmedikçe Unix epoch milisaniyesi (UTC)
- Yanıt biçimi
- json
- Kararlılık
- Beta
Canlı durum
KullanılabilirKontrol: 2026-11-13 03:53:49 UTCHTTP 2001 msŞema eşleşiyorEn yeni veri noktası 9m öncesine ait
Erişilebilirlik, son 30 gün
407 kontrolde başarı oranı: %99.75
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
GET
/api/research/statsKullanılabilirParametreler
string — Topic; 400 if unknown.
İstek URL'si
https://www.coinboss.com/api/research/stats?topic=liquidationBir 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.
Bu kategoride daha fazlası
- Veri kalitesi matrisi (toplayıcı görünümü) /api/sd/quality
- API kataloğu /api/meta/catalog
- Değişiklik günlüğü ve sürümleme politikası /api/meta/changelog
- Uç nokta dokümantasyonu /api/meta/endpoint
- OpenAPI belgesi /api/meta/openapi
- Veri kalitesi matrisi /api/meta/quality
- Servis durumu /api/meta/status
- Bir coin sembolünün platformda tanımlı olup olmadığını kontrol eder /api/coin-exists
- Coin sembolünden yerel olarak barındırılan simge yoluna eşleme /api/coin-icons
- Coin sayfası toplu özeti /api/content/coin
- Site geneli bölüm özeti /api/content/summary
- İtibari para döviz kuru tablosu /api/currency/fx
- Borsa kimliğinden yerel olarak barındırılan simge yoluna eşleme /api/exchange-icons
- Canlılık kontrolü /api/health
- Araştırma sayfası istatistikleri /api/research/stats