Funding kumulatif per bursa untuk satu koin
Funding kumulatif per bursa untuk satu koin
/api/funding/accumulatedPermintaan
Parameter kueri
| Nama | Tipe | Wajib | Default | Nilai yang diizinkan | Deskripsi |
|---|---|---|---|---|---|
| days | integer | Opsional | 7 | ≥ 1 · ≤ 90 | Jendela lihat-balik dalam hari. Contoh: 7 |
| base | string | Opsional | BTC | — | Simbol koin dasar (huruf besar, mis. BTC). Contoh: BTC |
Contoh permintaan
curl -s "https://www.coinboss.com/api/funding/accumulated?base=BTC&days=7"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 }`. |
| base | string | — | Simbol aset dasar. |
| days | number | — | Nilai harian atau jumlah hari. |
| unit | string | — | Satuan nilai dalam objek ini. |
| now | number | ms | Waktu server saat respons disusun. |
| series | array | — | Deret waktu. |
| series[] | object | — | Deret waktu. |
| series[].exchange | string | — | ID bursa, huruf kecil (misalnya `binance`). |
| series[].symbol | string | — | Simbol instrumen yang dinormalkan oleh CoinBoss (misalnya BTCUSDT). |
| series[].points | array | — | Titik data. |
| series[].points[] | array | — | Titik data. |
| series[].points[][] | number | — | Titik data. |
| series[].total_pct | number | % | Pangsa dari total. |
| series[].n | number | — | Jumlah item yang dihitung. |
| series[].n_expected | number | count | Jumlah penyelesaian yang seharusnya ada dalam satu jendela penuh: `days` × 24 ÷ `interval_h`; null jika interval penyelesaian tidak dapat ditentukan. |
| series[].interval_h | number | h | Interval funding. |
| series[].last_time | number | ms | Waktu penyelesaian terbaru. |
| series[].history_from | number | ms | Catatan penyelesaian paling awal yang tersimpan untuk kontrak ini. |
| series[].complete | boolean | — | True jika riwayat bursa mencakup awal jendela dan memuat minimal 90 % dari penyelesaian yang diharapkan; false berarti `total_pct` belum lengkap. |
| unavailable | array | — | Item yang datanya tidak tersedia, beserta alasannya. Tidak pernah dilaporkan sebagai 0. |
| unavailable[] | string | — | Item yang datanya tidak tersedia, beserta alasannya. Tidak pernah dilaporkan sebagai 0. |
| method | string | — | Catatan rumus / metode. |
Dihasilkan 2026-11-11 23:00 UTC dari 4 respons nyata.
Contoh respons
/api/funding/accumulated?base=BTC&days=7 · Respons nyata yang direkam 2026-11-13 04:02:35 UTC. Array dan map yang panjang dipersingkat untuk tampilan: series berisi 16 item; series[].points berisi 21 item.
- "success"true
- "base""BTC"
- "days"7
- "unit""pct"
- "now"1794542263852
- "series"
- "unavailable"
- "backpack"
- "bitfinex"
- "bitunix"
- "edgex"
- "lbank"
- "lighter"
- "paradex"
- "method""settled_records: cum = Σ 交易所实际结算费率(funding_settle,逐笔);1h/4h 结算的交易所每笔都计入;complete=false 为历史起点晚于窗口起点或窗内结算笔数不足(断档)"
Sampel terverifikasi
Selain contoh di atas, probe memanggil endpoint ini dengan parameter berikut dan memeriksa skemanya setiap kali.
| Parameter | HTTP | Latensi | Hasil |
|---|---|---|---|
| base=ETH&days=7 | 200 | 42 ms | Lolos |
| base=SOL&days=7 | 200 | 41 ms | Lolos |
| base=ARKM&days=7 | 200 | 37 ms | Lolos |
Diperiksa 2026-11-13 03:57:43 UTC
Detail
- Autentikasi
- Tidak ada. Endpoint publik.
- Batas permintaan
- 1200 permintaan per menit per IP
- Cache server
- 10m
- Mikro-cache edge
- 10s
- Frekuensi pembaruan
- per jam (kolektor derivatif dengan timer 60 menit; job penyelesaian lapisan data mandiri pada menit >= 6 setiap jam)
- Jendela
- parameter days, default 7, rentang 1..90
- Sumber data
- Catatan funding rate yang telah diselesaikan, di-polling setiap jam oleh kolektor internal dari endpoint riwayat funding publik 16 bursa (mis. binance, bybit, okx, gate, bitget, hyperliquid).
- Cakupan bursa
- 16 bursa; binance mencakup semua perpetual USDT; bybit / okx / gate / bitget mencakup 60 koin teratas menurut volume futures, htx 20 teratas; aster, hyperliquid, kucoin, mexc, bingx, kraken, dydx, deribit, whitebit, cryptocom menyimpan satu kontrak utama per koin; bitfinex tidak memiliki riwayat penyelesaian publik; kedalaman riwayat berbeda per bursa (binance / bybit / okx / bitget sejak 2026-04-04, lainnya lebih belakangan); bursa yang memiliki funding rate langsung tetapi tanpa riwayat penyelesaian tercantum di `unavailable`
- Pengurutan
- total_pct, menurun
- Satuan
- unit = 'pct': cumulative settled funding in percent (points = [funding_time ms, cumulative %]); total_pct in percent; interval_h in hours
- Metode
- 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)
- Stempel waktu
- Milidetik epoch Unix (UTC) kecuali deskripsi kolom menyatakan lain
- Format respons
- json
- Stabilitas
- Stabil
Status langsung
Bursa tanpa riwayat penyelesaian (tercantum di `unavailable`) tidak disertakan; bursa tersebut dilaporkan dengan namanya, bukan diisi dengan nol.
Ketersediaan, 30 hari terakhir
100% dari 411 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/funding/accumulatedSebagianinteger · default 7 · min 1 · maks 90 — Look-back window in days.
string · default BTC — Base coin symbol (uppercase, e.g. BTC).
https://www.coinboss.com/api/funding/accumulated?days=7&base=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