Tek coin için fonlama
Kendi veri katmanı: tek coin için fonlama (8h'ye normalize edilmiş, ağırlıklı)
/api/sd/fundingİstek
Sorgu parametreleri
| Ad | Tür | Zorunlu | Varsayılan | İzin verilen değerler | Açıklama |
|---|---|---|---|---|---|
| coin | string | Zorunlu | — | — | 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.
| 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. |
| coin | string | — | Coin sembolü, büyük harfle (örneğin BTC). |
| now | number | ms | Yanıtın oluşturulduğu andaki sunucu zamanı. |
| unit | string | — | Bu yanıttaki tüm oran alanlarının birimi: `fraction` (0.0001 = %0,01). |
| avg_8h | number | fraction per 8h | 8h'ye normalize edilmiş oranların basit ortalaması; borsa başına bir sözleşme. |
| oi_weighted_8h | number | fraction per 8h | 8h'ye normalize edilmiş oranların açık pozisyon ağırlıklı ortalaması. |
| apr_pct | number | % per year | Basit yıllıklandırma: 8h oranı × 3 × 365 × 100. |
| apr_basis | string | — | Öne çıkan `apr_pct` değerinin hangi toplu değere dayandığı. |
| n_exchanges | number | — | Katkıda bulunan borsa sayısı. |
| n_normalized | number | — | Fonlama aralığı bilinen ve 8h'ye normalize edilebilen borsalar. |
| n_unknown_interval | number | — | Fonlama aralığı bilinmediği için toplu değerlerin dışında bırakılan borsalar. |
| settled_cum_7d | object | — | 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.avg | number | fraction | Borsalar genelinde basit ortalama. |
| settled_cum_7d.oi_weighted | number | fraction | Açık pozisyon ağırlıklı ortalama. |
| settled_cum_7d.n | number | — | Penceresi eksiksiz olan borsalar. |
| settled_cum_30d | object | — | Aynısı, 30 gün için. |
| settled_cum_30d.avg | number | fraction | Borsalar genelinde basit ortalama. |
| settled_cum_30d.oi_weighted | number | fraction | Açık pozisyon ağırlıklı ortalama. |
| settled_cum_30d.n | number | — | Penceresi eksiksiz olan borsalar. |
| by_exchange | array | — | 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[].exchange | string | — | Borsa kimliği, küçük harfle (örneğin `binance`). |
| by_exchange[].symbol | string | — | CoinBoss'un normalize ettiği biçimiyle enstrüman sembolü (örneğin BTCUSDT). |
| by_exchange[].margin | string | — | Teminat para birimi sınıfı. |
| by_exchange[].kind | string | — | Tür. |
| by_exchange[].primary | boolean | — | Toplu değerlerde borsayı temsil eden sözleşme için true. |
| by_exchange[].rate | number | — | Borsanın yayımladığı biçimiyle içinde bulunulan dönemin fonlama oranı. |
| by_exchange[].interval_h | number | h | Fonlama aralığı. |
| by_exchange[].rate_8h | number | — | 8 saatlik döneme normalize edilmiş oran: rate × 8 / interval_h. |
| by_exchange[].apr_pct | number | % per year | Yıllıklandırılmış yüzde. |
| by_exchange[].next_funding_time | number|null | ms | Bir sonraki uzlaşma zamanı. |
| by_exchange[].next_derived | boolean | — | Bir sonraki uzlaşma zamanı borsa tarafından yayımlanmayıp aralıktan türetildiyse true. |
| by_exchange[].predicted_rate | null | — | Borsa yayımlıyorsa bir sonraki dönem için gösterge niteliğindeki oran; aksi hâlde null. |
| by_exchange[].oi_usd | number|null | USD | USD nominal değeri cinsinden açık pozisyon. |
| by_exchange[].updated_at | number | ms | Bu satırın en son güncellendiği zaman. |
| by_exchange[].age_s | number | s | Bu satırın son güncellenmesinden bu yana geçen saniye. |
| by_exchange[].is_stale | boolean | — | Satır güncellik penceresinden eskiyse true; eskimiş satırlar toplamlarda kullanılmaz. |
| by_exchange[].settled | object|null | — | Bu sözleşmenin fiilî uzlaşma kayıtları; borsanın herkese açık geçmişi yoksa null. |
| by_exchange[].settled.last_rate | number | — | En son uzlaşmanın oranı. bulunmayabilir |
| by_exchange[].settled.last_time | number | ms | En son uzlaşmanın zamanı. bulunmayabilir |
| by_exchange[].settled.interval_h | number | h | Fonlama aralığı. bulunmayabilir |
| by_exchange[].settled.cum_7d | number | — | Son 7 günde uzlaşılan oranların toplamı. bulunmayabilir |
| by_exchange[].settled.n_7d | number | — | Son 7 günde bulunan uzlaşmalar. bulunmayabilir |
| by_exchange[].settled.n_7d_expected | number | — | Bu aralıkla 7 günde beklenen uzlaşma sayısı. bulunmayabilir |
| by_exchange[].settled.cum_7d_complete | boolean | — | 7 günlük pencerede eksik uzlaşma yoksa true. bulunmayabilir |
| by_exchange[].settled.cum_30d | number | — | Son 30 günde uzlaşılan oranların toplamı. bulunmayabilir |
| by_exchange[].settled.n_30d | number | — | Son 30 günde bulunan uzlaşmalar. bulunmayabilir |
| by_exchange[].settled.n_30d_expected | number | — | Bu aralıkla 30 günde beklenen uzlaşma sayısı. bulunmayabilir |
| by_exchange[].settled.cum_30d_complete | boolean | — | 30 günlük pencerede eksik uzlaşma yoksa true. bulunmayabilir |
| by_exchange[].settled.history_from | number | ms | Bu sözleşme için tutulan en eski uzlaşma kaydı. bulunmayabilir |
| other_contracts | array | — | 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[].exchange | string | — | Borsa kimliği, küçük harfle (örneğin `binance`). |
| other_contracts[].symbol | string | — | CoinBoss'un normalize ettiği biçimiyle enstrüman sembolü (örneğin BTCUSDT). |
| other_contracts[].margin | string | — | Teminat para birimi sınıfı. |
| other_contracts[].kind | string | — | Tür. |
| other_contracts[].primary | boolean | — | Toplu değerlerde borsayı temsil eden sözleşme için true. |
| other_contracts[].rate | number | — | Borsanın yayımladığı biçimiyle içinde bulunulan dönemin fonlama oranı. |
| other_contracts[].interval_h | number|null | h | Fonlama aralığı. |
| other_contracts[].rate_8h | number|null | — | 8 saatlik döneme normalize edilmiş oran: rate × 8 / interval_h. |
| other_contracts[].apr_pct | number|null | % per year | Yıllıklandırılmış yüzde. |
| other_contracts[].next_funding_time | number|null | ms | Bir sonraki uzlaşma zamanı. |
| other_contracts[].next_derived | boolean | — | Bir sonraki uzlaşma zamanı borsa tarafından yayımlanmayıp aralıktan türetildiyse true. |
| other_contracts[].predicted_rate | number|null | — | Borsa yayımlıyorsa bir sonraki dönem için gösterge niteliğindeki oran; aksi hâlde null. |
| other_contracts[].oi_usd | number|null | USD | USD nominal değeri cinsinden açık pozisyon. |
| other_contracts[].updated_at | number | ms | Bu satırın en son güncellendiği zaman. |
| other_contracts[].age_s | number | s | Bu satırın son güncellenmesinden bu yana geçen saniye. |
| other_contracts[].is_stale | boolean | — | Satır güncellik penceresinden eskiyse true; eskimiş satırlar toplamlarda kullanılmaz. |
| other_contracts[].settled | object|null | — | Bu sözleşmenin fiilî uzlaşma kayıtları; borsanın herkese açık geçmişi yoksa null. |
| other_contracts[].settled.last_rate | number | — | En son uzlaşmanın oranı. bulunmayabilir |
| other_contracts[].settled.last_time | number | ms | En son uzlaşmanın zamanı. bulunmayabilir |
| other_contracts[].settled.interval_h | number | h | Fonlama aralığı. bulunmayabilir |
| other_contracts[].settled.cum_7d | number | — | Son 7 günde uzlaşılan oranların toplamı. bulunmayabilir |
| other_contracts[].settled.n_7d | number | — | Son 7 günde bulunan uzlaşmalar. bulunmayabilir |
| other_contracts[].settled.n_7d_expected | number | — | Bu aralıkla 7 günde beklenen uzlaşma sayısı. bulunmayabilir |
| other_contracts[].settled.cum_7d_complete | boolean | — | 7 günlük pencerede eksik uzlaşma yoksa true. bulunmayabilir |
| other_contracts[].settled.cum_30d | number | — | Son 30 günde uzlaşılan oranların toplamı. bulunmayabilir |
| other_contracts[].settled.n_30d | number | — | Son 30 günde bulunan uzlaşmalar. bulunmayabilir |
| other_contracts[].settled.n_30d_expected | number | — | Bu aralıkla 30 günde beklenen uzlaşma sayısı. bulunmayabilir |
| other_contracts[].settled.cum_30d_complete | boolean | — | 30 günlük pencerede eksik uzlaşma yoksa true. bulunmayabilir |
| other_contracts[].settled.history_from | number | ms | Bu sözleşme için tutulan en eski uzlaşma kaydı. bulunmayabilir |
| coverage | object | — | 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_exchanges | array | — | 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_history | array | — | 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_interval | array | — | Fonlama aralığı belirlenemeyen satırlar. bu tabloyu üretmek için kullanılan örneklerde boş |
| coverage.no_liveness_excluded | array | — | 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ş |
| method | object | — | Bu yanıtta kullanılan formüllerin düz metin açıklaması. |
| method.rate | string | — | Borsanın yayımladığı biçimiyle içinde bulunulan dönemin fonlama oranı. |
| method.rate_8h | string | — | 8 saatlik döneme normalize edilmiş oran: rate × 8 / interval_h. |
| method.apr_pct | string | % per year | Yıllıklandırılmış yüzde. |
| method.aggregate | string | — | Borsalar genelinde toplu değer. |
| method.settled | string | — | Bu sözleşmenin fiilî uzlaşma kayıtları; borsanın herkese açık geçmişi yoksa null. |
| method.predicted_rate | string | — | Borsa yayımlıyorsa bir sonraki dönem için gösterge niteliğindeki oran; aksi hâlde null. |
| method.liveness | string | — | Ö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"
- "other_contracts"
- "coverage"
- "settle_history_exchanges"
- "no_settle_history"
- "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.
| Parametreler | HTTP | Yanıt süresi | Sonuç |
|---|---|---|---|
| coin=ETH | 200 | 48 ms | Başarılı |
| coin=SOL | 200 | 48 ms | Başarılı |
| coin=ARKM | 200 | 47 ms | Başarılı |
| — | 400 | 1 ms | Baş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
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ı →
| 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/sd/fundingKullanılabilirstring — Coin symbol; 400 when missing. Alias: `base`.
https://www.coinboss.com/api/sd/funding?coin=BTCBu 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