/api/funding/accumulated
GETKısmi

Tek coin için borsa bazında kümülatif fonlama

Tek coin için borsa bazında kümülatif fonlama

GET/api/funding/accumulated
Kısmi kapsam. Uzlaşma geçmişi olmayan borsalar (`unavailable` içinde listelenir) dahil edilmez; sıfırla doldurulmak yerine adlarıyla bildirilirler.

İstek

Sorgu parametreleri

AdTürZorunluVarsayılanİzin verilen değerlerAçıklama
daysintegerİsteğe bağlı7≥ 1 · ≤ 90Gün cinsinden geriye dönük pencere. Örnek: 7
basestringİsteğe bağlıBTC—Temel coin sembolü (büyük harf, ör. BTC). Örnek: BTC

Örnek istek

curl -s "https://www.coinboss.com/api/funding/accumulated?base=BTC&days=7"

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.

AlanTürBirimAçıklama
successboolean—İstek başarılıysa true. Başarısızlık durumunda gövde `{ success: false, code, error, request_id }` olur.
basestring—Temel varlık sembolü.
daysnumber—Günlük değerler veya gün sayısı.
unitstring—Bu nesnedeki değerlerin birimi.
nownumbermsYanıtın oluşturulduğu andaki sunucu zamanı.
seriesarray—Zaman serisi.
series[]object—Zaman serisi.
series[].exchangestring—Borsa kimliği, küçük harfle (örneğin `binance`).
series[].symbolstring—CoinBoss'un normalize ettiği biçimiyle enstrüman sembolü (örneğin BTCUSDT).
series[].pointsarray—Veri noktaları.
series[].points[]array—Veri noktaları.
series[].points[][]number—Veri noktaları.
series[].total_pctnumber%Toplam içindeki pay.
series[].nnumber—Sayılan öğe sayısı.
series[].n_expectednumbercountTam bir pencerenin içermesi gereken uzlaşma sayısı: `days` × 24 ÷ `interval_h`; uzlaşma aralığı belirlenemiyorsa null.
series[].interval_hnumberhFonlama aralığı.
series[].last_timenumbermsEn son uzlaşmanın zamanı.
series[].history_fromnumbermsBu sözleşme için tutulan en eski uzlaşma kaydı.
series[].completeboolean—Borsanın geçmişi pencere başlangıcını kapsıyor ve beklenen uzlaşmaların en az %90'ını içeriyorsa true; false, `total_pct` değerinin kısmi olduğu anlamına gelir.
unavailablearray—Verisi bulunmayan öğeler, nedenleriyle birlikte. Hiçbir zaman 0 olarak bildirilmez.
unavailable[]string—Verisi bulunmayan öğeler, nedenleriyle birlikte. Hiçbir zaman 0 olarak bildirilmez.
methodstring—Formül / yöntem notları.

Üretilme zamanı: 2026-11-11 23:00 UTC; kaynak: 4 gerçek yanıt.

Örnek yanıt

/api/funding/accumulated?base=BTC&days=7 · Gerçek yanıt, yakalanma zamanı: 2026-11-13 03:57:43 UTC. Uzun diziler ve eşlemeler görüntüleme için kısaltılmıştır: series: 16 öğe içeriyordu; series[].points: 21 öğe içeriyordu.

  • {
    • "success": true,
    • "base": "BTC",
    • "days": 7,
    • "unit": "pct",
    • "now": 1794542263852,
    • "series": [
      • { … 10 },
      • { … 10 }
      ],
    • "unavailable": [
      • "backpack",
      • "bitfinex",
      • "bitunix",
      • "edgex",
      • "lbank",
      • "lighter",
      • "paradex"
      ],
    • "method": "settled_records: cum = Σ 交易所实际结算费率(funding_settle,逐笔);1h/4h 结算的交易所每笔都计入;complete=false 为历史起点晚于窗口起点或窗内结算笔数不足(断档)"
    }

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.

ParametrelerHTTPYanıt süresiSonuç
base=ETH&days=720042 msBaşarılı
base=SOL&days=720041 msBaşarılı
base=ARKM&days=720037 msBaşarılı

Kontrol: 2026-11-13 03:57:43 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
10m
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 7, aralık 1..90
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ı
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); canlı fonlama oranı olan ama uzlaşma geçmişi olmayan borsalar `unavailable` altında listelenir
Sıralama
total_pct, azalan
Birimler
unit = 'pct': cumulative settled funding in percent (points = [funding_time ms, cumulative %]); total_pct in percent; interval_h in hours
Yöntem
per exchange: cum = running SUM(settled rate) x 100 over the window for the contract with the most settlements; complete = history starts before the window AND settlement count >= 90% of floor(days x 24 / interval_h)
Zaman damgaları
Alan açıklamasında aksi belirtilmedikçe Unix epoch milisaniyesi (UTC)
Yanıt biçimi
json
Kararlılık
Kararlı

Canlı durum

KısmiKontrol: 2026-11-13 03:57:43 UTCHTTP 20043 msŞema eşleşiyorEn yeni veri noktası 58m öncesine ait

Uzlaşma geçmişi olmayan borsalar (`unavailable` içinde listelenir) dahil edilmez; sıfırla doldurulmak yerine adlarıyla bildirilirler.

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ı →

KodHTTPAnlamıNe yapmalı
INVALID_PARAM400Zorunlu 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.
UNAUTHORIZED401`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.
FORBIDDEN403Bu rota herkese açık API'nin parçası değildir (dahilî veya yalnızca hesaba özel).Yeniden denemeyin.
NOT_FOUND404Bilinmeyen rota ya da istenen coin / borsa / fon yok.Yeniden denemeyin; yolu ve tanımlayıcıları katalogla karşılaştırarak kontrol edin.
RATE_LIMITED429Dakika 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.
INTERNAL500Beklenmeyen 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_FAILED503Bu 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.
UNAVAILABLE501 / 503Veri 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_FAILED200Bazı 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/funding/accumulatedKısmi
Parametreler

integer · varsayılan 7 · en az 1 · en çok 90 — Look-back window in days.

string · varsayılan BTC — Base coin symbol (uppercase, e.g. BTC).

İstek URL'sihttps://www.coinboss.com/api/funding/accumulated?days=7&base=BTC
Bir 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.