Fonlama oranı ısı haritası
Fonlama oranı ısı haritası (coin × gün)
/api/funding/heatmapİstek
Sorgu parametreleri
| Ad | Tür | Zorunlu | Varsayılan | İzin verilen değerler | Açıklama |
|---|---|---|---|---|---|
| days | integer | İsteğe bağlı | 30 | ≥ 7 · ≤ 90 | Gün cinsinden geriye dönük pencere. Örnek: 30 |
| exchange | string | İsteğe bağlı | binance | — | Borsa kimliği (küçük harf, ör. binance). Örnek: binance |
| limit | integer | İsteğe bağlı | 50 | ≤ 100 | Döndürülecek satır sayısı. |
Örnek istek
curl -s "https://www.coinboss.com/api/funding/heatmap?exchange=binance&days=30"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 | string | — | Borsa kimliği, küçük harfle (örneğin `binance`). |
| days | number | — | Günlük değerler veya gün sayısı. |
| coins | array | — | Coinler. |
| coins[] | string | — | Coinler. |
| day_ts | array | — | Zaman damgası. |
| day_ts[] | number | ms | Zaman damgası. |
| matrix | array | — | Satır ve sütuna göre anahtarlanan matris. |
| matrix[] | array | — | Satır ve sütuna göre anahtarlanan matris. |
| matrix[][] | number|null | — | Satır ve sütuna göre anahtarlanan matris. |
Üretilme zamanı: 2026-11-11 23:00 UTC; kaynak: 3 gerçek yanıt.
Örnek yanıt
/api/funding/heatmap?exchange=binance&days=30 · Gerçek yanıt, yakalanma zamanı: 2026-11-13 03:57:47 UTC. Uzun diziler ve eşlemeler görüntüleme için kısaltılmıştır: coins: 50 öğe içeriyordu; day_ts: 30 öğe içeriyordu; matrix: 50 öğe içeriyordu; matrix[]: 30 öğe içeriyordu.
- "success"true
- "exchange""binance"
- "days"30
- "coins"
- "BTC"
- "ETH"
- "ZEC"
- "SOL"
- "XAU"
- "XRP"
- "HYPE"
- "XAG"
- "day_ts"
- 1792022400000
- 1792108800000
- 1792195200000
- 1792281600000
- 1792368000000
- 1792454400000
- 1792540800000
- 1792627200000
- "matrix"
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=30&exchange=okx | 200 | 65 ms | Başarılı |
| days=30&exchange=hyperliquid | 200 | 78 ms | Başarılı |
Kontrol: 2026-11-13 03:57:47 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ığı
- saatlik (deriv toplayıcısı 60 dakikalık zamanlayıcıyla; self-data uzlaşma görevi her saatin >= 6. dakikasında)
- Pencere
- days parametresi, varsayılan 30, aralık 7..90; her coin için UTC günü başına bir hücre
- Veri kaynakları
- Kurum içi toplayıcıların 16 borsanın (ör. binance, bybit, okx, gate, bitget, hyperliquid) herkese açık fonlama geçmişi uç noktalarından saatlik sorguladığı, uzlaşılmış fonlama oranı kayıtları.
- Borsa kapsamı
- istek başına bir borsa (exchange parametresi, varsayılan binance); vadeli hacme göre ilk sıralardaki coinler; kripto dışı semboller bir kripto beyaz listesiyle filtrelenir; 16 borsa; binance tüm USDT sürekli vadeli sözleşmelerini kapsar; bybit / okx / gate / bitget vadeli hacme göre ilk 60 coini, htx ilk 20 coini kapsar; aster, hyperliquid, kucoin, mexc, bingx, kraken, dydx, deribit, whitebit, cryptocom coin başına bir ana sözleşme tutar; bitfinex'in herkese açık uzlaşma geçmişi yoktur; geçmiş derinliği borsaya göre değişir (binance / bybit / okx / bitget 2026-04-04'ten itibaren, diğerleri daha sonra)
- Sayfalama
- limit = coin sayısı (varsayılan 50, en çok 100)
- Sıralama
- vadeli hacim, azalan
- Birimler
- cumulative settled funding in percent per UTC day; day_ts in Unix ms
- Yöntem
- cell = SUM(settled rate) x 100 over all settlements of that coin on that UTC day for the selected exchange
- 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
410 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/funding/heatmapKullanılabilirinteger · varsayılan 30 · en az 7 · en çok 90 — Look-back window in days.
string · varsayılan binance — Exchange id (lowercase, e.g. binance).
integer · varsayılan 50 · en çok 100 — Number of rows to return.
https://www.coinboss.com/api/funding/heatmap?days=30&exchange=binanceBu kategoride daha fazlası
- Tek coin için fonlama /api/sd/funding
- OI ağırlıklı / hacim ağırlıklı fonlama geçmişi /api/currency/funding-weighted
- Tek coin için borsa bazında fonlama oranı ayrıntısı /api/derivatives/funding-detail
- Tek coin için borsa bazında kümülatif fonlama /api/funding/accumulated
- Fonlama arbitrajı fırsatları /api/funding/arbitrage
- Tek coin için fonlama oranı grafik serisi /api/funding/chart
- Tek coin için borsalar genelinde güncel fonlama oranları /api/funding/coin
- Kümülatif fonlama ücretleri /api/funding/fees
- Fonlama oranı ısı haritası /api/funding/heatmap
- Tek coin için tek borsada fonlama oranı geçmişi /api/funding/history
- Fonlama oranı matrisi /api/funding/matrix
- Coin bazında fonlama oranı listesi /api/market/funding
- Borsalar arası fonlama oranı farkı sıralaması /api/market/funding-spread