/api/funding/chart
GETTersedia

Deret grafik funding rate untuk satu koin

Deret grafik funding rate untuk satu koin (per bursa)

GET/api/funding/chart
Kontrak yang dikuotasikan dalam kelipatan koin (misalnya `1000PEPE`) dicocokkan ke koin dasarnya. Garis berbobot OI menerapkan bobot open interest saat ini ke setiap titik historis; garis ini tidak dibobot dengan open interest pada masing-masing jam di masa lalu.

Permintaan

Parameter kueri

NamaTipeWajibDefaultNilai yang diizinkanDeskripsi
coinstringOpsionalBTC—Simbol koin dasar (huruf besar, mis. BTC). Contoh: BTC
hoursintegerOpsional720≥ 24 · ≤ 2160Jendela lihat-balik dalam jam. Contoh: 720

Contoh permintaan

curl -s "https://www.coinboss.com/api/funding/chart?coin=BTC&hours=720"

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).
hoursnumber—Nilai per jam atau jumlah jam.
exchangesarray—Bursa.
exchanges[]string—Bursa.
countnumber—Jumlah item.
dataarray—Payload.
data[]object—Payload.
data[].tsnumbermsStempel waktu.
data[].ratesobject—Rate.
data[].rates.asternumber—Nilai untuk bursa `aster` (kuncinya adalah ID bursa).
data[].rates.backpacknumber—Nilai untuk bursa `backpack` (kuncinya adalah ID bursa). bisa tidak ada
data[].rates.binancenumber—Nilai untuk bursa `binance` (kuncinya adalah ID bursa).
data[].rates.bingxnumber—Nilai untuk bursa `bingx` (kuncinya adalah ID bursa).
data[].rates.bitfinexnumber—Nilai untuk bursa `bitfinex` (kuncinya adalah ID bursa). bisa tidak ada
data[].rates.bitgetnumber—Nilai untuk bursa `bitget` (kuncinya adalah ID bursa).
data[].rates.bitmexnumber—Nilai untuk bursa `bitmex` (kuncinya adalah ID bursa). bisa tidak ada
data[].rates.bitunixnumber—Nilai untuk bursa `bitunix` (kuncinya adalah ID bursa).
data[].rates.bybitnumber—Nilai untuk bursa `bybit` (kuncinya adalah ID bursa).
data[].rates.coinbasenumber—Nilai untuk bursa `coinbase` (kuncinya adalah ID bursa). bisa tidak ada
data[].rates.coinexnumber—Nilai untuk bursa `coinex` (kuncinya adalah ID bursa).
data[].rates.cryptocomnumber—Nilai untuk bursa `cryptocom` (kuncinya adalah ID bursa).
data[].rates.deribitnumber—Nilai untuk bursa `deribit` (kuncinya adalah ID bursa). bisa tidak ada
data[].rates.dydxnumber—Nilai untuk bursa `dydx` (kuncinya adalah ID bursa).
data[].rates.edgexnumber—Nilai untuk bursa `edgex` (kuncinya adalah ID bursa). bisa tidak ada
data[].rates.gatenumber—Nilai untuk bursa `gate` (kuncinya adalah ID bursa).
data[].rates.htxnumber—Nilai untuk bursa `htx` (kuncinya adalah ID bursa). bisa tidak ada
data[].rates.hyperliquidnumber—Nilai untuk bursa `hyperliquid` (kuncinya adalah ID bursa). bisa tidak ada
data[].rates.krakennumber—Nilai untuk bursa `kraken` (kuncinya adalah ID bursa).
data[].rates.kucoinnumber—Nilai untuk bursa `kucoin` (kuncinya adalah ID bursa).
data[].rates.lbanknumber—Nilai untuk bursa `lbank` (kuncinya adalah ID bursa).
data[].rates.lighternumber—Nilai untuk bursa `lighter` (kuncinya adalah ID bursa). bisa tidak ada
data[].rates.mexcnumber—Nilai untuk bursa `mexc` (kuncinya adalah ID bursa).
data[].rates.okxnumber—Nilai untuk bursa `okx` (kuncinya adalah ID bursa). bisa tidak ada
data[].rates.paradexnumber—Nilai untuk bursa `paradex` (kuncinya adalah ID bursa). bisa tidak ada
data[].rates.whitebitnumber—Nilai untuk bursa `whitebit` (kuncinya adalah ID bursa).
data[].oi_weightednumber—Nilai berbobot open interest.
data[].avgnumber—Rata-rata.
pricearray—Harga terakhir dalam mata uang kuotasi (USD atau USDT kecuali dinyatakan lain).
price[]object—Harga terakhir dalam mata uang kuotasi (USD atau USDT kecuali dinyatakan lain).
price[].tsnumbermsStempel waktu.
price[].pricenumber—Harga terakhir dalam mata uang kuotasi (USD atau USDT kecuali dinyatakan lain).

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

Contoh respons

/api/funding/chart?coin=BTC&hours=720 · Respons nyata yang direkam 2026-11-13 03:57:44 UTC. Array dan map yang panjang dipersingkat untuk tampilan: data berisi 720 item; price berisi 720 item; exchanges berisi 26 item.

  • {
    • "success": true,
    • "coin": "BTC",
    • "hours": 720,
    • "exchanges": [
      • "binance",
      • "okx",
      • "bybit",
      • "bitget",
      • "gate",
      • "htx",
      • "coinex",
      • "bitmex"
      ],
    • "count": 720,
    • "data": [
      • { … 4 },
      • { … 4 }
      ],
    • "price": [
      • { … 2 },
      • { … 2 }
      ]
    }

Sampel terverifikasi

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

ParameterHTTPLatensiHasil
coin=ETH&hours=720200114 msLolos
coin=SOL&hours=720200102 msLolos
coin=ARKM&hours=72020084 msLolos

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

Detail

Autentikasi
Tidak ada. Endpoint publik.
Batas permintaan
1200 permintaan per menit per IP
Cache server
5m
Mikro-cache edge
10s
Frekuensi pembaruan
arsip per jam pada setiap pergantian jam UTC (snapshot tabel terbaru); salinan ClickHouse disinkronkan setiap 5 min
Jendela
parameter hours, default 720 h, rentang 24..2160 h; titik per jam
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
bursa yang kontraknya bernama COINUSDT, COIN-USDT-SWAP, atau COIN_USDT
Satuan
rates in percent per funding interval (raw rate x 100); price = 1 h kline close in USD; ts in Unix ms
Metode
per hour: rates[exchange] = rate x 100; avg = simple mean; oi_weighted = SUM(rate x w) / SUM(w) where w = each exchange's CURRENT open interest (constant weights over the whole series)
Stempel waktu
Milidetik epoch Unix (UTC) kecuali deskripsi kolom menyatakan lain
Format respons
json
Stabilitas
Stabil

Status langsung

TersediaDiperiksa 2026-11-13 03:57:44 UTCHTTP 200139 msSkema sesuaiTitik data terbaru berusia 58m

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/funding/chartTersedia
Parameter

string · default BTC — Base coin symbol (uppercase, e.g. BTC).

integer · default 720 · min 24 · maks 2160 — Look-back window in hours.

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