Funding untuk satu koin
Lapisan data mandiri: funding untuk satu koin (dinormalkan 8h, berbobot)
/api/sd/fundingPermintaan
Parameter kueri
| Nama | Tipe | Wajib | Default | Nilai yang diizinkan | Deskripsi |
|---|---|---|---|---|---|
| coin | string | Wajib | — | — | 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.
| Kolom | Tipe | Satuan | Deskripsi |
|---|---|---|---|
| success | boolean | — | true jika permintaan berhasil. Jika gagal, body-nya adalah `{ success: false, code, error, request_id }`. |
| coin | string | — | Simbol koin, huruf besar (misalnya BTC). |
| now | number | ms | Waktu server saat respons disusun. |
| unit | string | — | Satuan semua kolom rate dalam respons ini: `fraction` (0.0001 = 0.01 %). |
| avg_8h | number | fraction per 8h | Rata-rata sederhana rate yang dinormalkan 8h, satu kontrak per bursa. |
| oi_weighted_8h | number | fraction per 8h | Rata-rata berbobot open interest dari rate yang dinormalkan 8h. |
| apr_pct | number | % per year | Penahunan sederhana: rate 8h × 3 × 365 × 100. |
| apr_basis | string | — | Agregat yang menjadi dasar `apr_pct` utama. |
| n_exchanges | number | — | Jumlah bursa yang berkontribusi. |
| n_normalized | number | — | Bursa yang interval funding-nya diketahui dan dapat dinormalkan ke 8h. |
| n_unknown_interval | number | — | Bursa yang tidak disertakan dalam agregat karena interval funding-nya tidak diketahui. |
| settled_cum_7d | object | — | Jumlah funding rate yang benar-benar diselesaikan selama 7 hari terakhir, dirata-ratakan lintas bursa yang memiliki riwayat penyelesaian. |
| settled_cum_7d.avg | number | fraction | Rata-rata sederhana lintas bursa. |
| settled_cum_7d.oi_weighted | number | fraction | Rata-rata berbobot open interest. |
| settled_cum_7d.n | number | — | Bursa dengan jendela yang lengkap. |
| settled_cum_30d | object | — | Sama, selama 30 hari. |
| settled_cum_30d.avg | number | fraction | Rata-rata sederhana lintas bursa. |
| settled_cum_30d.oi_weighted | number | fraction | Rata-rata berbobot open interest. |
| settled_cum_30d.n | number | — | Bursa dengan jendela yang lengkap. |
| by_exchange | array | — | Satu baris per bursa: kontrak utamanya untuk koin ini (yang open interest-nya terbesar). |
| by_exchange[] | object | — | Rincian per bursa. |
| by_exchange[].exchange | string | — | ID bursa, huruf kecil (misalnya `binance`). |
| by_exchange[].symbol | string | — | Simbol instrumen yang dinormalkan oleh CoinBoss (misalnya BTCUSDT). |
| by_exchange[].margin | string | — | Kelas mata uang margin. |
| by_exchange[].kind | string | — | Jenis. |
| by_exchange[].primary | boolean | — | true untuk kontrak yang mewakili bursa dalam agregat. |
| by_exchange[].rate | number | — | Funding rate periode berjalan sebagaimana dipublikasikan bursa. |
| by_exchange[].interval_h | number | h | Interval funding. |
| by_exchange[].rate_8h | number | — | Rate yang dinormalkan ke periode 8 jam: rate × 8 / interval_h. |
| by_exchange[].apr_pct | number | % per year | Persentase tahunan. |
| by_exchange[].next_funding_time | number|null | ms | Waktu penyelesaian berikutnya. |
| by_exchange[].next_derived | boolean | — | true jika waktu penyelesaian berikutnya diturunkan dari interval, bukan dipublikasikan oleh bursa. |
| by_exchange[].predicted_rate | null | — | Rate indikatif periode berikutnya jika bursa memublikasikannya; jika tidak, null. |
| by_exchange[].oi_usd | number|null | USD | Open interest dalam nosional USD. |
| by_exchange[].updated_at | number | ms | Waktu baris ini terakhir diperbarui. |
| by_exchange[].age_s | number | s | Jumlah detik sejak baris ini terakhir diperbarui. |
| by_exchange[].is_stale | boolean | — | true jika baris lebih lama daripada jendela kesegaran; baris usang tidak dipakai dalam total. |
| by_exchange[].settled | object|null | — | Catatan penyelesaian aktual untuk kontrak ini; null jika bursa tidak memiliki riwayat publik. |
| by_exchange[].settled.last_rate | number | — | Rate penyelesaian terbaru. bisa tidak ada |
| by_exchange[].settled.last_time | number | ms | Waktu penyelesaian terbaru. bisa tidak ada |
| by_exchange[].settled.interval_h | number | h | Interval funding. bisa tidak ada |
| by_exchange[].settled.cum_7d | number | — | Jumlah rate yang diselesaikan selama 7 hari terakhir. bisa tidak ada |
| by_exchange[].settled.n_7d | number | — | Penyelesaian yang ditemukan dalam 7 hari terakhir. bisa tidak ada |
| by_exchange[].settled.n_7d_expected | number | — | Penyelesaian yang diharapkan dalam 7 hari pada interval ini. bisa tidak ada |
| by_exchange[].settled.cum_7d_complete | boolean | — | true jika tidak ada penyelesaian yang hilang dalam jendela 7 hari. bisa tidak ada |
| by_exchange[].settled.cum_30d | number | — | Jumlah rate yang diselesaikan selama 30 hari terakhir. bisa tidak ada |
| by_exchange[].settled.n_30d | number | — | Penyelesaian yang ditemukan dalam 30 hari terakhir. bisa tidak ada |
| by_exchange[].settled.n_30d_expected | number | — | Penyelesaian yang diharapkan dalam 30 hari pada interval ini. bisa tidak ada |
| by_exchange[].settled.cum_30d_complete | boolean | — | true jika tidak ada penyelesaian yang hilang dalam jendela 30 hari. bisa tidak ada |
| by_exchange[].settled.history_from | number | ms | Catatan penyelesaian paling awal yang tersimpan untuk kontrak ini. bisa tidak ada |
| other_contracts | array | — | 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[].exchange | string | — | ID bursa, huruf kecil (misalnya `binance`). |
| other_contracts[].symbol | string | — | Simbol instrumen yang dinormalkan oleh CoinBoss (misalnya BTCUSDT). |
| other_contracts[].margin | string | — | Kelas mata uang margin. |
| other_contracts[].kind | string | — | Jenis. |
| other_contracts[].primary | boolean | — | true untuk kontrak yang mewakili bursa dalam agregat. |
| other_contracts[].rate | number | — | Funding rate periode berjalan sebagaimana dipublikasikan bursa. |
| other_contracts[].interval_h | number|null | h | Interval funding. |
| other_contracts[].rate_8h | number|null | — | Rate yang dinormalkan ke periode 8 jam: rate × 8 / interval_h. |
| other_contracts[].apr_pct | number|null | % per year | Persentase tahunan. |
| other_contracts[].next_funding_time | number|null | ms | Waktu penyelesaian berikutnya. |
| other_contracts[].next_derived | boolean | — | true jika waktu penyelesaian berikutnya diturunkan dari interval, bukan dipublikasikan oleh bursa. |
| other_contracts[].predicted_rate | number|null | — | Rate indikatif periode berikutnya jika bursa memublikasikannya; jika tidak, null. |
| other_contracts[].oi_usd | number|null | USD | Open interest dalam nosional USD. |
| other_contracts[].updated_at | number | ms | Waktu baris ini terakhir diperbarui. |
| other_contracts[].age_s | number | s | Jumlah detik sejak baris ini terakhir diperbarui. |
| other_contracts[].is_stale | boolean | — | true jika baris lebih lama daripada jendela kesegaran; baris usang tidak dipakai dalam total. |
| other_contracts[].settled | object|null | — | Catatan penyelesaian aktual untuk kontrak ini; null jika bursa tidak memiliki riwayat publik. |
| other_contracts[].settled.last_rate | number | — | Rate penyelesaian terbaru. bisa tidak ada |
| other_contracts[].settled.last_time | number | ms | Waktu penyelesaian terbaru. bisa tidak ada |
| other_contracts[].settled.interval_h | number | h | Interval funding. bisa tidak ada |
| other_contracts[].settled.cum_7d | number | — | Jumlah rate yang diselesaikan selama 7 hari terakhir. bisa tidak ada |
| other_contracts[].settled.n_7d | number | — | Penyelesaian yang ditemukan dalam 7 hari terakhir. bisa tidak ada |
| other_contracts[].settled.n_7d_expected | number | — | Penyelesaian yang diharapkan dalam 7 hari pada interval ini. bisa tidak ada |
| other_contracts[].settled.cum_7d_complete | boolean | — | true jika tidak ada penyelesaian yang hilang dalam jendela 7 hari. bisa tidak ada |
| other_contracts[].settled.cum_30d | number | — | Jumlah rate yang diselesaikan selama 30 hari terakhir. bisa tidak ada |
| other_contracts[].settled.n_30d | number | — | Penyelesaian yang ditemukan dalam 30 hari terakhir. bisa tidak ada |
| other_contracts[].settled.n_30d_expected | number | — | Penyelesaian yang diharapkan dalam 30 hari pada interval ini. bisa tidak ada |
| other_contracts[].settled.cum_30d_complete | boolean | — | true jika tidak ada penyelesaian yang hilang dalam jendela 30 hari. bisa tidak ada |
| other_contracts[].settled.history_from | number | ms | Catatan penyelesaian paling awal yang tersimpan untuk kontrak ini. bisa tidak ada |
| coverage | object | — | Apa yang termasuk dan tidak termasuk dalam angka di atas. Bandingkan ini terlebih dahulu sebelum membandingkan total dengan sumber lain. |
| coverage.settle_history_exchanges | array | — | 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_history | array | — | 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_interval | array | — | Baris yang interval funding-nya tidak dapat ditentukan. kosong pada sampel yang dipakai untuk menghasilkan tabel ini |
| coverage.no_liveness_excluded | array | — | 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 |
| method | object | — | Pernyataan teks biasa tentang rumus yang dipakai untuk respons ini. |
| method.rate | string | — | Funding rate periode berjalan sebagaimana dipublikasikan bursa. |
| method.rate_8h | string | — | Rate yang dinormalkan ke periode 8 jam: rate × 8 / interval_h. |
| method.apr_pct | string | % per year | Persentase tahunan. |
| method.aggregate | string | — | Agregat lintas bursa. |
| method.settled | string | — | Catatan penyelesaian aktual untuk kontrak ini; null jika bursa tidak memiliki riwayat publik. |
| method.predicted_rate | string | — | Rate indikatif periode berikutnya jika bursa memublikasikannya; jika tidak, null. |
| method.liveness | string | — | 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"
- "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 …"
Sampel terverifikasi
Selain contoh di atas, probe memanggil endpoint ini dengan parameter berikut dan memeriksa skemanya setiap kali.
| Parameter | HTTP | Latensi | Hasil |
|---|---|---|---|
| coin=ETH | 200 | 43 ms | Lolos |
| coin=SOL | 200 | 44 ms | Lolos |
| coin=ARKM | 200 | 41 ms | Lolos |
| — | 400 | 1 ms | Lolos 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
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 →
| Kode | HTTP | Arti | Tindakan |
|---|---|---|---|
| INVALID_PARAM | 400 | Parameter wajib tidak ada atau suatu nilai tidak diterima. `param` menyebutkan nama parameternya jika diketahui. | Jangan mengulang tanpa perubahan; perbaiki permintaannya. |
| UNAUTHORIZED | 401 | Header `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. |
| FORBIDDEN | 403 | Rute ini bukan bagian dari API publik (internal atau khusus akun). | Jangan mengulang. |
| NOT_FOUND | 404 | Rute tidak dikenal, atau koin / bursa / dana yang diminta tidak ada. | Jangan mengulang; periksa path dan pengenal terhadap katalog. |
| RATE_LIMITED | 429 | Jumlah permintaan melebihi batas per menit. `Retry-After` memberikan jumlah detik untuk menunggu. | Tunggu selama `Retry-After`, lalu ulangi dengan backoff. |
| INTERNAL | 500 | Error 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_FAILED | 503 | Sumber 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. |
| UNAVAILABLE | 501 / 503 | Dataset 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_FAILED | 200 | Beberapa endpoint lama menjawab HTTP 200 dengan `success: false`. Selalu periksa `success`, bukan hanya status HTTP. | Bergantung pada pesannya; perlakukan sebagai permintaan yang gagal. |
Coba
/api/sd/fundingTersediastring — Coin symbol; 400 when missing. Alias: `base`.
https://www.coinboss.com/api/sd/funding?coin=BTCLainnya di kategori ini
- Funding untuk satu koin /api/sd/funding
- Riwayat funding berbobot OI / berbobot volume /api/currency/funding-weighted
- Detail funding rate per bursa untuk satu koin /api/derivatives/funding-detail
- Funding kumulatif per bursa untuk satu koin /api/funding/accumulated
- Peluang arbitrase funding /api/funding/arbitrage
- Deret grafik funding rate untuk satu koin /api/funding/chart
- Funding rate saat ini untuk satu koin lintas bursa /api/funding/coin
- Biaya funding kumulatif /api/funding/fees
- Heatmap funding rate /api/funding/heatmap
- Riwayat funding rate untuk satu koin di satu bursa /api/funding/history
- Matriks funding rate /api/funding/matrix
- Daftar funding rate per koin /api/market/funding
- Peringkat selisih funding rate lintas bursa /api/market/funding-spread