/api/sd/funding
GETTersedia

Funding untuk satu koin

Lapisan data mandiri: funding untuk satu koin (dinormalkan 8h, berbobot)

GET/api/sd/funding

Permintaan

Parameter kueri

NamaTipeWajibDefaultNilai yang diizinkanDeskripsi
coinstringWajib——Simbol koin; 400 jika tidak ada. Alias: `base`. Contoh: BTC

Contoh permintaan

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

Kolom respons

Tabel kolom dihasilkan dari respons nyata, sehingga memuat persis apa yang dikembalikan endpoint. Path memakai a[] untuk item array dan {*} untuk objek yang kuncinya berupa nama dinamis seperti koin atau bursa.

KolomTipeSatuanDeskripsi
successboolean—true jika permintaan berhasil. Jika gagal, body-nya adalah `{ success: false, code, error, request_id }`.
coinstring—Simbol koin, huruf besar (misalnya BTC).
nownumbermsWaktu server saat respons disusun.
unitstring—Satuan semua kolom rate dalam respons ini: `fraction` (0.0001 = 0.01 %).
avg_8hnumberfraction per 8hRata-rata sederhana rate yang dinormalkan 8h, satu kontrak per bursa.
oi_weighted_8hnumberfraction per 8hRata-rata berbobot open interest dari rate yang dinormalkan 8h.
apr_pctnumber% per yearPenahunan sederhana: rate 8h × 3 × 365 × 100.
apr_basisstring—Agregat yang menjadi dasar `apr_pct` utama.
n_exchangesnumber—Jumlah bursa yang berkontribusi.
n_normalizednumber—Bursa yang interval funding-nya diketahui dan dapat dinormalkan ke 8h.
n_unknown_intervalnumber—Bursa yang tidak disertakan dalam agregat karena interval funding-nya tidak diketahui.
settled_cum_7dobject—Jumlah funding rate yang benar-benar diselesaikan selama 7 hari terakhir, dirata-ratakan lintas bursa yang memiliki riwayat penyelesaian.
settled_cum_7d.avgnumberfractionRata-rata sederhana lintas bursa.
settled_cum_7d.oi_weightednumberfractionRata-rata berbobot open interest.
settled_cum_7d.nnumber—Bursa dengan jendela yang lengkap.
settled_cum_30dobject—Sama, selama 30 hari.
settled_cum_30d.avgnumberfractionRata-rata sederhana lintas bursa.
settled_cum_30d.oi_weightednumberfractionRata-rata berbobot open interest.
settled_cum_30d.nnumber—Bursa dengan jendela yang lengkap.
by_exchangearray—Satu baris per bursa: kontrak utamanya untuk koin ini (yang open interest-nya terbesar).
by_exchange[]object—Rincian per bursa.
by_exchange[].exchangestring—ID bursa, huruf kecil (misalnya `binance`).
by_exchange[].symbolstring—Simbol instrumen yang dinormalkan oleh CoinBoss (misalnya BTCUSDT).
by_exchange[].marginstring—Kelas mata uang margin.
by_exchange[].kindstring—Jenis.
by_exchange[].primaryboolean—true untuk kontrak yang mewakili bursa dalam agregat.
by_exchange[].ratenumber—Funding rate periode berjalan sebagaimana dipublikasikan bursa.
by_exchange[].interval_hnumberhInterval funding.
by_exchange[].rate_8hnumber—Rate yang dinormalkan ke periode 8 jam: rate × 8 / interval_h.
by_exchange[].apr_pctnumber% per yearPersentase tahunan.
by_exchange[].next_funding_timenumber|nullmsWaktu penyelesaian berikutnya.
by_exchange[].next_derivedboolean—true jika waktu penyelesaian berikutnya diturunkan dari interval, bukan dipublikasikan oleh bursa.
by_exchange[].predicted_ratenull—Rate indikatif periode berikutnya jika bursa memublikasikannya; jika tidak, null.
by_exchange[].oi_usdnumber|nullUSDOpen interest dalam nosional USD.
by_exchange[].updated_atnumbermsWaktu baris ini terakhir diperbarui.
by_exchange[].age_snumbersJumlah detik sejak baris ini terakhir diperbarui.
by_exchange[].is_staleboolean—true jika baris lebih lama daripada jendela kesegaran; baris usang tidak dipakai dalam total.
by_exchange[].settledobject|null—Catatan penyelesaian aktual untuk kontrak ini; null jika bursa tidak memiliki riwayat publik.
by_exchange[].settled.last_ratenumber—Rate penyelesaian terbaru. bisa tidak ada
by_exchange[].settled.last_timenumbermsWaktu penyelesaian terbaru. bisa tidak ada
by_exchange[].settled.interval_hnumberhInterval funding. bisa tidak ada
by_exchange[].settled.cum_7dnumber—Jumlah rate yang diselesaikan selama 7 hari terakhir. bisa tidak ada
by_exchange[].settled.n_7dnumber—Penyelesaian yang ditemukan dalam 7 hari terakhir. bisa tidak ada
by_exchange[].settled.n_7d_expectednumber—Penyelesaian yang diharapkan dalam 7 hari pada interval ini. bisa tidak ada
by_exchange[].settled.cum_7d_completeboolean—true jika tidak ada penyelesaian yang hilang dalam jendela 7 hari. bisa tidak ada
by_exchange[].settled.cum_30dnumber—Jumlah rate yang diselesaikan selama 30 hari terakhir. bisa tidak ada
by_exchange[].settled.n_30dnumber—Penyelesaian yang ditemukan dalam 30 hari terakhir. bisa tidak ada
by_exchange[].settled.n_30d_expectednumber—Penyelesaian yang diharapkan dalam 30 hari pada interval ini. bisa tidak ada
by_exchange[].settled.cum_30d_completeboolean—true jika tidak ada penyelesaian yang hilang dalam jendela 30 hari. bisa tidak ada
by_exchange[].settled.history_fromnumbermsCatatan penyelesaian paling awal yang tersimpan untuk kontrak ini. bisa tidak ada
other_contractsarray—Kontrak lain untuk koin yang sama (USDC, bermargin koin, …). Bukan bagian dari agregat.
other_contracts[]object—Satu kontrak funding tambahan milik suatu bursa (bermargin koin, USDC, …) yang bukan kontrak utamanya dan dikecualikan dari agregat.
other_contracts[].exchangestring—ID bursa, huruf kecil (misalnya `binance`).
other_contracts[].symbolstring—Simbol instrumen yang dinormalkan oleh CoinBoss (misalnya BTCUSDT).
other_contracts[].marginstring—Kelas mata uang margin.
other_contracts[].kindstring—Jenis.
other_contracts[].primaryboolean—true untuk kontrak yang mewakili bursa dalam agregat.
other_contracts[].ratenumber—Funding rate periode berjalan sebagaimana dipublikasikan bursa.
other_contracts[].interval_hnumber|nullhInterval funding.
other_contracts[].rate_8hnumber|null—Rate yang dinormalkan ke periode 8 jam: rate × 8 / interval_h.
other_contracts[].apr_pctnumber|null% per yearPersentase tahunan.
other_contracts[].next_funding_timenumber|nullmsWaktu penyelesaian berikutnya.
other_contracts[].next_derivedboolean—true jika waktu penyelesaian berikutnya diturunkan dari interval, bukan dipublikasikan oleh bursa.
other_contracts[].predicted_ratenumber|null—Rate indikatif periode berikutnya jika bursa memublikasikannya; jika tidak, null.
other_contracts[].oi_usdnumber|nullUSDOpen interest dalam nosional USD.
other_contracts[].updated_atnumbermsWaktu baris ini terakhir diperbarui.
other_contracts[].age_snumbersJumlah detik sejak baris ini terakhir diperbarui.
other_contracts[].is_staleboolean—true jika baris lebih lama daripada jendela kesegaran; baris usang tidak dipakai dalam total.
other_contracts[].settledobject|null—Catatan penyelesaian aktual untuk kontrak ini; null jika bursa tidak memiliki riwayat publik.
other_contracts[].settled.last_ratenumber—Rate penyelesaian terbaru. bisa tidak ada
other_contracts[].settled.last_timenumbermsWaktu penyelesaian terbaru. bisa tidak ada
other_contracts[].settled.interval_hnumberhInterval funding. bisa tidak ada
other_contracts[].settled.cum_7dnumber—Jumlah rate yang diselesaikan selama 7 hari terakhir. bisa tidak ada
other_contracts[].settled.n_7dnumber—Penyelesaian yang ditemukan dalam 7 hari terakhir. bisa tidak ada
other_contracts[].settled.n_7d_expectednumber—Penyelesaian yang diharapkan dalam 7 hari pada interval ini. bisa tidak ada
other_contracts[].settled.cum_7d_completeboolean—true jika tidak ada penyelesaian yang hilang dalam jendela 7 hari. bisa tidak ada
other_contracts[].settled.cum_30dnumber—Jumlah rate yang diselesaikan selama 30 hari terakhir. bisa tidak ada
other_contracts[].settled.n_30dnumber—Penyelesaian yang ditemukan dalam 30 hari terakhir. bisa tidak ada
other_contracts[].settled.n_30d_expectednumber—Penyelesaian yang diharapkan dalam 30 hari pada interval ini. bisa tidak ada
other_contracts[].settled.cum_30d_completeboolean—true jika tidak ada penyelesaian yang hilang dalam jendela 30 hari. bisa tidak ada
other_contracts[].settled.history_fromnumbermsCatatan penyelesaian paling awal yang tersimpan untuk kontrak ini. bisa tidak ada
coverageobject—Apa yang termasuk dan tidak termasuk dalam angka di atas. Bandingkan ini terlebih dahulu sebelum membandingkan total dengan sumber lain.
coverage.settle_history_exchangesarray—Bursa yang catatan penyelesaian aktualnya dikumpulkan.
coverage.settle_history_exchanges[]string—ID bursa yang catatan penyelesaian funding aktualnya dikumpulkan untuk koin ini.
coverage.no_settle_historyarray—Bursa tanpa sumber riwayat penyelesaian publik; `settled`-nya bernilai null.
coverage.no_settle_history[]string—ID bursa dari kontrak utama yang tidak memiliki riwayat penyelesaian terkumpul, sehingga blok `settled`-nya bernilai null.
coverage.unknown_intervalarray—Baris yang interval funding-nya tidak dapat ditentukan. kosong pada sampel yang dipakai untuk menghasilkan tabel ini
coverage.no_liveness_excludedarray—Baris yang dikecualikan karena kontraknya tidak menunjukkan tanda perdagangan (tidak ada ticker, open interest, atau kuotasi terbaru). kosong pada sampel yang dipakai untuk menghasilkan tabel ini
methodobject—Pernyataan teks biasa tentang rumus yang dipakai untuk respons ini.
method.ratestring—Funding rate periode berjalan sebagaimana dipublikasikan bursa.
method.rate_8hstring—Rate yang dinormalkan ke periode 8 jam: rate × 8 / interval_h.
method.apr_pctstring% per yearPersentase tahunan.
method.aggregatestring—Agregat lintas bursa.
method.settledstring—Catatan penyelesaian aktual untuk kontrak ini; null jika bursa tidak memiliki riwayat publik.
method.predicted_ratestring—Rate indikatif periode berikutnya jika bursa memublikasikannya; jika tidak, null.
method.livenessstring—Aturan teks biasa untuk membuang kontrak mati: baris funding hanya dihitung jika memiliki ticker dalam 1h terakhir, open interest dalam 3h terakhir, atau kuotasi sendiri dalam 3h terakhir.

Dihasilkan 2026-11-11 23:00 UTC dari 4 respons nyata.

Contoh respons

/api/sd/funding?coin=BTC · Respons nyata yang direkam 2026-11-13 03:57:42 UTC. Array dan map yang panjang dipersingkat untuk tampilan: by_exchange berisi 23 item; other_contracts berisi 18 item; coverage.settle_history_exchanges berisi 16 item.

  • {
    • "success": true,
    • "coin": "BTC",
    • "now": 1794542262267,
    • "unit": "fraction",
    • "avg_8h": 0.00006731782608695654,
    • "oi_weighted_8h": 0.00005745116946489526,
    • "apr_pct": 6.2909,
    • "apr_basis": "oi_weighted_8h",
    • "n_exchanges": 23,
    • "n_normalized": 23,
    • "n_unknown_interval": 0,
    • "settled_cum_7d": {
      • "avg": 0.0016089506666666666,
      • "oi_weighted": 0.0015317230977727185,
      • "n": 15
      },
    • "settled_cum_30d": {
      • "avg": 0.0066857086666666675,
      • "oi_weighted": 0.006362887957085279,
      • "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 …"
      }
    }

Sampel terverifikasi

Selain contoh di atas, probe memanggil endpoint ini dengan parameter berikut dan memeriksa skemanya setiap kali.

ParameterHTTPLatensiHasil
coin=ETH20043 msLolos
coin=SOL20044 msLolos
coin=ARKM20041 msLolos
—4001 msLolos mengembalikan error yang diharapkan

Diperiksa 2026-11-13 03:57:42 UTC

Detail

Autentikasi
Tidak ada. Endpoint publik.
Batas permintaan
1200 permintaan per menit per IP
Cache server
20s
Mikro-cache edge
10s
Frekuensi pembaruan
setiap 60 s untuk sebagian besar bursa (ditulis bersama ticker; binance memiliki job khusus 60 s); job funding lainnya dan kontrak bermargin koin setiap 5 min; catatan penyelesaian setiap jam
Jendela
snapshot terbaru (baris funding dalam 4 h terakhir pada kontrak dengan ticker / OI yang aktif); jumlah penyelesaian selama 7 d dan 30 d
Sumber data
Funding rate saat ini yang di-polling oleh kolektor internal dari API REST publik 24 bursa perpetual (mis. binance, okx, bybit, bitget, gate, hyperliquid).
Cakupan bursa
24 bursa untuk rate saat ini; riwayat penyelesaian dari 16 bursa (kontrak perpetual bermargin koin di binance, okx, bybit disimpan terpisah)
Satuan
unit = 'fraction' (0.0001 = 0.01%); rate_8h normalized to 8 h; apr_pct in percent; times in Unix ms
Metode
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)
Stempel waktu
Milidetik epoch Unix (UTC) kecuali deskripsi kolom menyatakan lain
Format respons
json
Stabilitas
Stabil
Tersedia sejak
2026-11-11

Status langsung

TersediaDiperiksa 2026-11-13 03:57:42 UTCHTTP 20052 msSkema sesuaiTitik data terbaru berusia 1s

Ketersediaan, 30 hari terakhir

100% dari 410 pemeriksaan lolos

Error

Panggilan yang gagal memiliki satu bentuk yang sama di semua endpoint. Daftar lengkapnya ada di halaman error. Error dan batas permintaan →

KodeHTTPArtiTindakan
INVALID_PARAM400Parameter wajib tidak ada atau suatu nilai tidak diterima. `param` menyebutkan nama parameternya jika diketahui.Jangan mengulang tanpa perubahan; perbaiki permintaannya.
UNAUTHORIZED401Header `CB-API-KEY` dikirim tetapi kuncinya tidak dikenal atau sudah dicabut. Data publik tidak memerlukan kunci — hapus header tersebut atau gunakan kunci yang valid.Jangan mengulang tanpa perubahan.
FORBIDDEN403Rute ini bukan bagian dari API publik (internal atau khusus akun).Jangan mengulang.
NOT_FOUND404Rute tidak dikenal, atau koin / bursa / dana yang diminta tidak ada.Jangan mengulang; periksa path dan pengenal terhadap katalog.
RATE_LIMITED429Jumlah permintaan melebihi batas per menit. `Retry-After` memberikan jumlah detik untuk menunggu.Tunggu selama `Retry-After`, lalu ulangi dengan backoff.
INTERNAL500Error server yang tidak terduga. Pesannya sengaja dibuat generik; sertakan `request_id` saat melaporkannya.Ulangi sekali setelah beberapa detik; laporkan beserta ID permintaan jika masih terjadi.
UPSTREAM_FAILED503Sumber data di balik endpoint ini tidak menjawab tepat waktu. Tidak ada angka usang atau angka pengganti yang dikembalikan sebagai gantinya.Ulangi dengan backoff; periksa halaman status.
UNAVAILABLE501 / 503Dataset untuk sementara belum siap (cache sedang diisi) atau endpoint belum memiliki sumber publik yang sah.Ulangi nanti; katalog menandai endpoint yang memang tidak tersedia secara desain.
REQUEST_FAILED200Beberapa endpoint lama menjawab HTTP 200 dengan `success: false`. Selalu periksa `success`, bukan hanya status HTTP.Bergantung pada pesannya; perlakukan sebagai permintaan yang gagal.

Coba

GET/api/sd/fundingTersedia
Parameter

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

URL permintaanhttps://www.coinboss.com/api/sd/funding?coin=BTC
Pilih endpoint lalu tekan “Kirim permintaan”. Respons, header, dan waktu tempuhnya akan muncul di sini.