/api/funding/heatmap
GETTersedia

Heatmap funding rate

Heatmap funding rate (koin × hari)

GET/api/funding/heatmap

Permintaan

Parameter kueri

NamaTipeWajibDefaultNilai yang diizinkanDeskripsi
daysintegerOpsional30≥ 7 · ≤ 90Jendela lihat-balik dalam hari. Contoh: 30
exchangestringOpsionalbinance—ID bursa (huruf kecil, mis. binance). Contoh: binance
limitintegerOpsional50≤ 100Jumlah baris yang dikembalikan.

Contoh permintaan

curl -s "https://www.coinboss.com/api/funding/heatmap?exchange=binance&days=30"

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 }`.
exchangestring—ID bursa, huruf kecil (misalnya `binance`).
daysnumber—Nilai harian atau jumlah hari.
coinsarray—Koin.
coins[]string—Koin.
day_tsarray—Stempel waktu.
day_ts[]numbermsStempel waktu.
matrixarray—Matriks dengan kunci baris dan kolom.
matrix[]array—Matriks dengan kunci baris dan kolom.
matrix[][]number|null—Matriks dengan kunci baris dan kolom.

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

Contoh respons

/api/funding/heatmap?exchange=binance&days=30 · Respons nyata yang direkam 2026-11-13 04:02:36 UTC. Array dan map yang panjang dipersingkat untuk tampilan: coins berisi 50 item; day_ts berisi 30 item; matrix berisi 50 item; matrix[] berisi 30 item.

  • {
    • "success": true,
    • "exchange": "binance",
    • "days": 30,
    • "coins": [
      • "BTC",
      • "ETH",
      • "ZEC",
      • "SOL",
      • "XAU",
      • "XRP",
      • "HYPE",
      • "XAG"
      ],
    • "day_ts": [
      • 1792022400000,
      • 1792108800000,
      • 1792195200000,
      • 1792281600000,
      • 1792368000000,
      • 1792454400000,
      • 1792540800000,
      • 1792627200000
      ],
    • "matrix": [
      • [ … 8 ],
      • [ … 8 ]
      ]
    }

Sampel terverifikasi

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

ParameterHTTPLatensiHasil
days=30&exchange=okx20065 msLolos
days=30&exchange=hyperliquid20078 msLolos

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

Detail

Autentikasi
Tidak ada. Endpoint publik.
Batas permintaan
1200 permintaan per menit per IP
Cache server
5m
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 30, rentang 7..90; satu sel per koin per hari UTC
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
satu bursa per permintaan (parameter exchange, default binance); koin teratas menurut volume futures; simbol non-kripto difilter dengan whitelist kripto; 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)
Paginasi
limit = jumlah koin (default 50, maks 100)
Pengurutan
volume futures, menurun
Satuan
cumulative settled funding in percent per UTC day; day_ts in Unix ms
Metode
cell = SUM(settled rate) x 100 over all settlements of that coin on that UTC day for the selected exchange
Stempel waktu
Milidetik epoch Unix (UTC) kecuali deskripsi kolom menyatakan lain
Format respons
json
Stabilitas
Stabil

Status langsung

TersediaDiperiksa 2026-11-13 04:02:36 UTCHTTP 2001 msSkema sesuaiTitik data terbaru berusia 4h

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 →

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/heatmapTersedia
Parameter

integer · default 30 · min 7 · maks 90 — Look-back window in days.

string · default binance — Exchange id (lowercase, e.g. binance).

integer · default 50 · maks 100 — Number of rows to return.

URL permintaanhttps://www.coinboss.com/api/funding/heatmap?days=30&exchange=binance
Pilih endpoint lalu tekan “Kirim permintaan”. Respons, header, dan waktu tempuhnya akan muncul di sini.