/api/sd/funding
GETKullanılabilir

Tek coin için fonlama

Kendi veri katmanı: tek coin için fonlama (8h'ye normalize edilmiş, ağırlıklı)

GET/api/sd/funding

İstek

Sorgu parametreleri

AdTürZorunluVarsayılanİzin verilen değerlerAçıklama
coinstringZorunlu——Coin sembolü; eksikse 400. Takma ad: `base`. Örnek: BTC

Örnek istek

curl -s "https://www.coinboss.com/api/sd/funding?coin=BTC"

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.
coinstring—Coin sembolü, büyük harfle (örneğin BTC).
nownumbermsYanıtın oluşturulduğu andaki sunucu zamanı.
unitstring—Bu yanıttaki tüm oran alanlarının birimi: `fraction` (0.0001 = %0,01).
avg_8hnumberfraction per 8h8h'ye normalize edilmiş oranların basit ortalaması; borsa başına bir sözleşme.
oi_weighted_8hnumberfraction per 8h8h'ye normalize edilmiş oranların açık pozisyon ağırlıklı ortalaması.
apr_pctnumber% per yearBasit yıllıklandırma: 8h oranı × 3 × 365 × 100.
apr_basisstring—Öne çıkan `apr_pct` değerinin hangi toplu değere dayandığı.
n_exchangesnumber—Katkıda bulunan borsa sayısı.
n_normalizednumber—Fonlama aralığı bilinen ve 8h'ye normalize edilebilen borsalar.
n_unknown_intervalnumber—Fonlama aralığı bilinmediği için toplu değerlerin dışında bırakılan borsalar.
settled_cum_7dobject—Son 7 günde fiilen uzlaşılan fonlama oranlarının toplamı; uzlaşma geçmişi olan borsalar genelinde ortalaması alınır.
settled_cum_7d.avgnumberfractionBorsalar genelinde basit ortalama.
settled_cum_7d.oi_weightednumberfractionAçık pozisyon ağırlıklı ortalama.
settled_cum_7d.nnumber—Penceresi eksiksiz olan borsalar.
settled_cum_30dobject—Aynısı, 30 gün için.
settled_cum_30d.avgnumberfractionBorsalar genelinde basit ortalama.
settled_cum_30d.oi_weightednumberfractionAçık pozisyon ağırlıklı ortalama.
settled_cum_30d.nnumber—Penceresi eksiksiz olan borsalar.
by_exchangearray—Borsa başına bir satır: borsanın bu coine ait ana sözleşmesi (açık pozisyonu en büyük olan).
by_exchange[]object—Borsa bazında dağılım.
by_exchange[].exchangestring—Borsa kimliği, küçük harfle (örneğin `binance`).
by_exchange[].symbolstring—CoinBoss'un normalize ettiği biçimiyle enstrüman sembolü (örneğin BTCUSDT).
by_exchange[].marginstring—Teminat para birimi sınıfı.
by_exchange[].kindstring—Tür.
by_exchange[].primaryboolean—Toplu değerlerde borsayı temsil eden sözleşme için true.
by_exchange[].ratenumber—Borsanın yayımladığı biçimiyle içinde bulunulan dönemin fonlama oranı.
by_exchange[].interval_hnumberhFonlama aralığı.
by_exchange[].rate_8hnumber—8 saatlik döneme normalize edilmiş oran: rate × 8 / interval_h.
by_exchange[].apr_pctnumber% per yearYıllıklandırılmış yüzde.
by_exchange[].next_funding_timenumber|nullmsBir sonraki uzlaşma zamanı.
by_exchange[].next_derivedboolean—Bir sonraki uzlaşma zamanı borsa tarafından yayımlanmayıp aralıktan türetildiyse true.
by_exchange[].predicted_ratenull—Borsa yayımlıyorsa bir sonraki dönem için gösterge niteliğindeki oran; aksi hâlde null.
by_exchange[].oi_usdnumber|nullUSDUSD nominal değeri cinsinden açık pozisyon.
by_exchange[].updated_atnumbermsBu satırın en son güncellendiği zaman.
by_exchange[].age_snumbersBu satırın son güncellenmesinden bu yana geçen saniye.
by_exchange[].is_staleboolean—Satır güncellik penceresinden eskiyse true; eskimiş satırlar toplamlarda kullanılmaz.
by_exchange[].settledobject|null—Bu sözleşmenin fiilî uzlaşma kayıtları; borsanın herkese açık geçmişi yoksa null.
by_exchange[].settled.last_ratenumber—En son uzlaşmanın oranı. bulunmayabilir
by_exchange[].settled.last_timenumbermsEn son uzlaşmanın zamanı. bulunmayabilir
by_exchange[].settled.interval_hnumberhFonlama aralığı. bulunmayabilir
by_exchange[].settled.cum_7dnumber—Son 7 günde uzlaşılan oranların toplamı. bulunmayabilir
by_exchange[].settled.n_7dnumber—Son 7 günde bulunan uzlaşmalar. bulunmayabilir
by_exchange[].settled.n_7d_expectednumber—Bu aralıkla 7 günde beklenen uzlaşma sayısı. bulunmayabilir
by_exchange[].settled.cum_7d_completeboolean—7 günlük pencerede eksik uzlaşma yoksa true. bulunmayabilir
by_exchange[].settled.cum_30dnumber—Son 30 günde uzlaşılan oranların toplamı. bulunmayabilir
by_exchange[].settled.n_30dnumber—Son 30 günde bulunan uzlaşmalar. bulunmayabilir
by_exchange[].settled.n_30d_expectednumber—Bu aralıkla 30 günde beklenen uzlaşma sayısı. bulunmayabilir
by_exchange[].settled.cum_30d_completeboolean—30 günlük pencerede eksik uzlaşma yoksa true. bulunmayabilir
by_exchange[].settled.history_fromnumbermsBu sözleşme için tutulan en eski uzlaşma kaydı. bulunmayabilir
other_contractsarray—Aynı coinin diğer sözleşmeleri (USDC, coin teminatlı, …). Toplu değerlere dahil değildir.
other_contracts[]object—Bir borsanın, birincil sözleşmesi olmayan ve toplu değerlere dahil edilmeyen ek bir fonlama sözleşmesi (coin teminatlı, USDC, …).
other_contracts[].exchangestring—Borsa kimliği, küçük harfle (örneğin `binance`).
other_contracts[].symbolstring—CoinBoss'un normalize ettiği biçimiyle enstrüman sembolü (örneğin BTCUSDT).
other_contracts[].marginstring—Teminat para birimi sınıfı.
other_contracts[].kindstring—Tür.
other_contracts[].primaryboolean—Toplu değerlerde borsayı temsil eden sözleşme için true.
other_contracts[].ratenumber—Borsanın yayımladığı biçimiyle içinde bulunulan dönemin fonlama oranı.
other_contracts[].interval_hnumber|nullhFonlama aralığı.
other_contracts[].rate_8hnumber|null—8 saatlik döneme normalize edilmiş oran: rate × 8 / interval_h.
other_contracts[].apr_pctnumber|null% per yearYıllıklandırılmış yüzde.
other_contracts[].next_funding_timenumber|nullmsBir sonraki uzlaşma zamanı.
other_contracts[].next_derivedboolean—Bir sonraki uzlaşma zamanı borsa tarafından yayımlanmayıp aralıktan türetildiyse true.
other_contracts[].predicted_ratenumber|null—Borsa yayımlıyorsa bir sonraki dönem için gösterge niteliğindeki oran; aksi hâlde null.
other_contracts[].oi_usdnumber|nullUSDUSD nominal değeri cinsinden açık pozisyon.
other_contracts[].updated_atnumbermsBu satırın en son güncellendiği zaman.
other_contracts[].age_snumbersBu satırın son güncellenmesinden bu yana geçen saniye.
other_contracts[].is_staleboolean—Satır güncellik penceresinden eskiyse true; eskimiş satırlar toplamlarda kullanılmaz.
other_contracts[].settledobject|null—Bu sözleşmenin fiilî uzlaşma kayıtları; borsanın herkese açık geçmişi yoksa null.
other_contracts[].settled.last_ratenumber—En son uzlaşmanın oranı. bulunmayabilir
other_contracts[].settled.last_timenumbermsEn son uzlaşmanın zamanı. bulunmayabilir
other_contracts[].settled.interval_hnumberhFonlama aralığı. bulunmayabilir
other_contracts[].settled.cum_7dnumber—Son 7 günde uzlaşılan oranların toplamı. bulunmayabilir
other_contracts[].settled.n_7dnumber—Son 7 günde bulunan uzlaşmalar. bulunmayabilir
other_contracts[].settled.n_7d_expectednumber—Bu aralıkla 7 günde beklenen uzlaşma sayısı. bulunmayabilir
other_contracts[].settled.cum_7d_completeboolean—7 günlük pencerede eksik uzlaşma yoksa true. bulunmayabilir
other_contracts[].settled.cum_30dnumber—Son 30 günde uzlaşılan oranların toplamı. bulunmayabilir
other_contracts[].settled.n_30dnumber—Son 30 günde bulunan uzlaşmalar. bulunmayabilir
other_contracts[].settled.n_30d_expectednumber—Bu aralıkla 30 günde beklenen uzlaşma sayısı. bulunmayabilir
other_contracts[].settled.cum_30d_completeboolean—30 günlük pencerede eksik uzlaşma yoksa true. bulunmayabilir
other_contracts[].settled.history_fromnumbermsBu sözleşme için tutulan en eski uzlaşma kaydı. bulunmayabilir
coverageobject—Yukarıdaki sayılara nelerin dahil olduğu ve nelerin olmadığı. Toplamları başka bir kaynakla karşılaştırmadan önce bunu karşılaştırın.
coverage.settle_history_exchangesarray—Fiilî uzlaşma kayıtları toplanan borsalar.
coverage.settle_history_exchanges[]string—Bu coin için gerçekleşen fonlama uzlaşma kayıtları toplanan borsanın kimliği.
coverage.no_settle_historyarray—Herkese açık bir uzlaşma geçmişi kaynağı olmayan borsalar; bunların `settled` değeri null olur.
coverage.no_settle_history[]string—Uzlaşma geçmişi toplanmamış birincil sözleşmenin borsa kimliği; bu nedenle `settled` bloğu null olur.
coverage.unknown_intervalarray—Fonlama aralığı belirlenemeyen satırlar. bu tabloyu üretmek için kullanılan örneklerde boş
coverage.no_liveness_excludedarray—Sözleşmede hiçbir işlem belirtisi görülmediği (güncel ticker, açık pozisyon veya kotasyon bulunmadığı) için hariç tutulan satırlar. bu tabloyu üretmek için kullanılan örneklerde boş
methodobject—Bu yanıtta kullanılan formüllerin düz metin açıklaması.
method.ratestring—Borsanın yayımladığı biçimiyle içinde bulunulan dönemin fonlama oranı.
method.rate_8hstring—8 saatlik döneme normalize edilmiş oran: rate × 8 / interval_h.
method.apr_pctstring% per yearYıllıklandırılmış yüzde.
method.aggregatestring—Borsalar genelinde toplu değer.
method.settledstring—Bu sözleşmenin fiilî uzlaşma kayıtları; borsanın herkese açık geçmişi yoksa null.
method.predicted_ratestring—Borsa yayımlıyorsa bir sonraki dönem için gösterge niteliğindeki oran; aksi hâlde null.
method.livenessstring—Ölü sözleşmelerin elenmesine ilişkin düz metin kural: bir fonlama satırı yalnızca son 1h içinde bir ticker, son 3h içinde açık pozisyon ya da son 3h içinde kendi kotasyonu varsa sayılır.

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

Örnek yanıt

/api/sd/funding?coin=BTC · Gerçek yanıt, yakalanma zamanı: 2026-11-12 23:22:35 UTC. Uzun diziler ve eşlemeler görüntüleme için kısaltılmıştır: by_exchange: 23 öğe içeriyordu; other_contracts: 18 öğe içeriyordu; coverage.settle_history_exchanges: 16 öğe içeriyordu.

  • {
    • "success": true,
    • "coin": "BTC",
    • "now": 1794525755277,
    • "unit": "fraction",
    • "avg_8h": 0.00010477173913043478,
    • "oi_weighted_8h": 0.00009757689825105314,
    • "apr_pct": 10.6847,
    • "apr_basis": "oi_weighted_8h",
    • "n_exchanges": 23,
    • "n_normalized": 23,
    • "n_unknown_interval": 0,
    • "settled_cum_7d": {
      • "avg": 0.0015883406666666671,
      • "oi_weighted": 0.0015239805955996888,
      • "n": 15
      },
    • "settled_cum_30d": {
      • "avg": 0.006603366666666667,
      • "oi_weighted": 0.006283756667582393,
      • "n": 15
      },
    • "by_exchange": [
      • { … 17 },
      • { … 17 }
      ],
    • "other_contracts": [
      • { … 17 },
      • { … 17 }
      ],
    • "coverage": {
      • "settle_history_exchanges": [ … 8 ],
      • "no_settle_history": [ … 7 ],
      • "unknown_interval": [],
      • "no_liveness_excluded": []
      },
    • "method": {
      • "rate": "current funding-period rate as published by the exchange (charged at next settlement; may change until then)",
      • "rate_8h": "rate × 8 / interval_h (rows with unknown interval excluded from aggregates)",
      • "apr_pct": "per exchange: rate_8h × 3 × 365 × 100; headline apr_pct = oi_weighted_8h × 3 × 365 × 100 (falls back to avg_8h when no OI weights; see apr_basis). Simple annual…",
      • "aggregate": "one contract per exchange (largest OI); avg_8h = simple mean; oi_weighted_8h = Σ(rate_8h × oi_usd)/Σoi_usd",
      • "settled": "actual settlement records collected from each exchange funding-history endpoint; cum = Σ settled rates in window",
      • "predicted_rate": "exchange-published indicative/next-period rate where available",
      • "liveness": "a funding row is used only if the same contract on the same exchange has a ticker within 1h, open interest within 3h, or a self-collected quote within 3h; rows …"
      }
    }

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ç
coin=ETH20048 msBaşarılı
coin=SOL20048 msBaşarılı
coin=ARKM20047 msBaşarılı
—4001 msBaşarılı beklenen hatayı döndürür

Kontrol: 2026-11-12 22:57:42 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
20s
Edge mikro önbelleği
10s
Güncelleme sıklığı
çoğu borsa için 60 s'de bir (ticker'larla birlikte yazılır; binance için ayrılmış 60 s'lik görev); kalan fonlama görevleri ve coin teminatlı sözleşmeler 5 dakikada bir; uzlaşma kayıtları saatlik
Pencere
en güncel anlık görüntü (canlı ticker'ı / OI'si olan sözleşmelerde son 4 saat içindeki fonlama satırları); 7 günlük ve 30 günlük uzlaşılan toplamlar
Veri kaynakları
Kurum içi toplayıcıların 24 sürekli vadeli borsasının (ör. binance, okx, bybit, bitget, gate, hyperliquid) herkese açık REST API'lerinden sorguladığı güncel fonlama oranları.
Borsa kapsamı
güncel oranlar için 24 borsa; uzlaşma geçmişi 16 borsadan (binance, okx, bybit'in coin teminatlı sürekli vadeli sözleşmeleri ayrı tutulur)
Birimler
unit = 'fraction' (0.0001 = 0.01%); rate_8h normalized to 8 h; apr_pct in percent; times in Unix ms
Yöntem
one contract per exchange (largest OI); rate_8h = rate x 8 / interval_hours; avg_8h = simple mean; oi_weighted_8h = SUM(rate_8h x oi_usd) / SUM(oi_usd); apr_pct = rate_8h x 3 x 365 x 100; settled 7 d / 30 d = SUM of settlement records with a completeness flag (>= 90% of expected settlements)
Zaman damgaları
Alan açıklamasında aksi belirtilmedikçe Unix epoch milisaniyesi (UTC)
Yanıt biçimi
json
Kararlılık
Kararlı
Kullanıma sunulma
2026-11-11

Canlı durum

KullanılabilirKontrol: 2026-11-12 23:22:35 UTCHTTP 20036 msŞema eşleşiyorEn yeni veri noktası 40s öncesine ait

Erişilebilirlik, son 30 gün

355 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/sd/fundingKullanılabilir
Parametreler

string — Coin symbol; 400 when missing. Alias: `base`.

İstek URL'sihttps://www.coinboss.com/api/sd/funding?coin=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.