/api/derivatives/coins
GETTersedia

Screener koin derivatif

Screener koin derivatif (harga, OI, funding, RSI, long/short, likuidasi; dapat difilter)

GET/api/derivatives/coins

Permintaan

Parameter kueri

NamaTipeWajibDefaultNilai yang diizinkanDeskripsi
limitintegerOpsional50≤ 500Jumlah baris yang dikembalikan. Contoh: 50
offsetintegerOpsional0—Offset paginasi.
onlyWatchliststringOpsional—1=1 membatasi pada watchlist pemanggil (memerlukan JWT, tidak di-cache).
exchangesstringOpsional——Whitelist bursa yang dipisahkan koma (27 bursa); 400 jika tidak ada yang valid.
minMarketCapnumberOpsional——Filter: kapitalisasi pasar minimum (USD).
maxMarketCapnumberOpsional——Filter: kapitalisasi pasar maksimum (USD).
minOinumberOpsional——Filter: open interest minimum (USD).
maxOinumberOpsional——Filter: open interest maksimum (USD).
minFundingnumberOpsional——Filter: funding rate minimum.
maxFundingnumberOpsional——Filter: funding rate maksimum.
minRsi1hnumberOpsional——Filter: RSI 1h minimum.
maxRsi1hnumberOpsional——Filter: RSI 1h maksimum.
minRsi4hnumberOpsional——Filter: RSI 4h minimum.
maxRsi4hnumberOpsional——Filter: RSI 4h maksimum.
minRsi1dnumberOpsional——Filter: RSI 1d minimum.
maxRsi1dnumberOpsional——Filter: RSI 1d maksimum.
minChangePctnumberOpsional——Filter: perubahan 24h minimum (%).
maxChangePctnumberOpsional——Filter: perubahan 24h maksimum (%).
minVolumenumberOpsional——Filter: volume 24h minimum (USD).
maxVolumenumberOpsional——Filter: volume 24h maksimum (USD).
minLiq24hnumberOpsional——Filter: likuidasi 24h minimum (USD).
maxLiq24hnumberOpsional——Filter: likuidasi 24h maksimum (USD).
minLsAccountnumberOpsional——Filter: rasio long/short akun minimum.
maxLsAccountnumberOpsional——Filter: rasio long/short akun maksimum.
minOiChg1hnumberOpsional——Filter: perubahan OI 1h minimum (%).
maxOiChg1hnumberOpsional——Filter: perubahan OI 1h maksimum (%).
minOiChg24hnumberOpsional——Filter: perubahan OI 24h minimum (%).
maxOiChg24hnumberOpsional——Filter: perubahan OI 24h maksimum (%).

Contoh permintaan

curl -s "https://www.coinboss.com/api/derivatives/coins?limit=50"

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 }`.
nownumbermsWaktu server saat respons disusun.
totalnumber—Total.
dataarray—Payload.
data[]object—Payload.
data[].coinstring—Simbol koin, huruf besar (misalnya BTC).
data[].namestring—Nama.
data[].image_urlstring—Path ikon same-origin yang disajikan CoinBoss; null jika tidak ada ikon terverifikasi.
data[].market_capnumber—Kapitalisasi pasar.
data[].pricenumber—Harga terakhir dalam mata uang kuotasi (USD atau USDT kecuali dinyatakan lain).
data[].change_pctnumber%Perubahan persentase.
data[].volume_usdnumberUSDVolume dalam nosional USD.
data[].rsi_1hnumber—RSI(14) pada candlestick 1h.
data[].rsi_4hnumber—RSI(14) pada candlestick 4h.
data[].rsi_1dnumber—RSI(14) pada candlestick harian.
data[].basis_pctnumber|null%(futures − spot) / spot × 100.
data[].basis_annual_pctnull% per yearBasis yang ditahunkan berdasarkan jumlah hari hingga jatuh tempo.
data[].oi_usdnumberUSDOpen interest dalam nosional USD.
data[].funding_avgnumber—Rata-rata funding rate lintas bursa.
data[].ls_accountnumber|null—Rasio long/short berdasarkan akun.
data[].ls_takernumber|null—Rasio beli/jual taker.
data[].liq_24h_usdnumberUSDLikuidasi 24h.
data[].oi_chg_1h_pctnumber%Perubahan open interest 1h.
data[].oi_chg_24h_pctnumber%Perubahan open interest 24h.
data[].vol_chg_24h_pctnumber%Perubahan volume 24h.
data[].updated_atnumbermsWaktu baris ini terakhir diperbarui.

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

Contoh respons

/api/derivatives/coins?limit=50 · Respons nyata yang direkam 2026-11-13 03:57:37 UTC. Array dan map yang panjang dipersingkat untuk tampilan: data berisi 50 item.

  • {
    • "success": true,
    • "now": 1794542257654,
    • "total": 800,
    • "data": [
      • { … 21 },
      • { … 21 }
      ]
    }

Detail

Autentikasi
Tidak ada. Endpoint publik.
Batas permintaan
1200 permintaan per menit per IP
Cache server
5s
Mikro-cache edge
10s
Frekuensi pembaruan
metrik turunan: 100 koin teratas setiap 5 min, peringkat 101-400 setiap 15 min, peringkat 401-980 setiap 30 min; ticker setiap 60 s; harga langsung dikirim melalui WebSocket
Jendela
snapshot terbaru (ticker dalam 1 h terakhir)
Sumber data
Metrik derivatif per koin yang dihitung sendiri di muka dari kolektor bursa milik CoinBoss (25 sumber, mis. binance, okx, bybit, bitget, gate, hyperliquid); nama koin, ikon, dan kapitalisasi pasar berasal dari agregator data pasar pihak ketiga.
Cakupan bursa
hingga 980 koin yang diperingkat menurut open interest agregat (801 baris saat audit); parameter `exchanges` dibatasi pada whitelist 27 bursa
Paginasi
limit (default 50, maks 500)
Pengurutan
oi_usd, menurun
Satuan
oi / volume / liquidations in USD; change and RSI fields as percent / index values; funding as raw fraction; market_cap in USD
Metode
oi_usd = cross-exchange open interest (all contract types, multiplier contracts folded); RSI(14) on 1 h / 4 h (aggregated from 1 h) / 1 d klines; oi_chg = change vs hourly archive; liq_24h_usd = 24 h SUM(value_usd); with the `exchanges` param metrics are recomputed at request time for the selected venues
Stempel waktu
Milidetik epoch Unix (UTC) kecuali deskripsi kolom menyatakan lain
Format respons
json
Stabilitas
Stabil

Status langsung

TersediaDiperiksa 2026-11-13 03:57:37 UTCHTTP 20025 msSkema sesuaiTitik data terbaru berusia 4m

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/derivatives/coinsTersedia
Parameter

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

integer · default 0 — Pagination offset.

string — =1 restricts to the caller watchlist (JWT required, uncached).

string — Comma-separated exchange whitelist (27 venues); 400 if none valid.

number — Filter: minimum market cap (USD).

number — Filter: maximum market cap (USD).

number — Filter: minimum open interest (USD).

number — Filter: maximum open interest (USD).

number — Filter: minimum funding rate.

number — Filter: maximum funding rate.

number — Filter: minimum 1h RSI.

number — Filter: maximum 1h RSI.

number — Filter: minimum 4h RSI.

number — Filter: maximum 4h RSI.

number — Filter: minimum 1d RSI.

number — Filter: maximum 1d RSI.

number — Filter: minimum 24h change (%).

number — Filter: maximum 24h change (%).

number — Filter: minimum 24h volume (USD).

number — Filter: maximum 24h volume (USD).

number — Filter: minimum 24h liquidations (USD).

number — Filter: maximum 24h liquidations (USD).

number — Filter: minimum account long/short ratio.

number — Filter: maximum account long/short ratio.

number — Filter: minimum 1h OI change (%).

number — Filter: maximum 1h OI change (%).

number — Filter: minimum 24h OI change (%).

number — Filter: maximum 24h OI change (%).

URL permintaanhttps://www.coinboss.com/api/derivatives/coins?limit=50
Pilih endpoint lalu tekan “Kirim permintaan”. Respons, header, dan waktu tempuhnya akan muncul di sini.