Volume 24j—Open Interest—Likuidasi 24j$1.36BLong/Short 24j—Dominasi BTC—Dominasi ETH—
Aplikasi
Bahasa ▾
Rp IDR ▾
/api/liquidations/tradfi
GETTersedia

Ikhtisar likuidasi kontrak perpetual TradFi

Ikhtisar likuidasi kontrak perpetual TradFi (saham / indeks / komoditas / forex)

GET/api/liquidations/tradfi

Permintaan

Parameter kueri

NamaTipeWajibDefaultNilai yang diizinkanDeskripsi
rangestringOpsional24h1h, 4h, 12h, 24hJendela waktu. Contoh: 24h
classstringOpsionalstockstock, index, commodity, forexKelas aset; nilai yang tidak dikenal mengembalikan 400. Contoh: stock
limitintegerOpsional30≤ 100Jumlah baris yang dikembalikan.

Contoh permintaan

curl -s "https://www.coinboss.com/api/liquidations/tradfi?class=stock&range=24h"

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 }`.
rangestring—Jendela yang diminta.
classstring—Kelas aset.
overviewobject—Blok ikhtisar.
overview.long_usdnumberUSDSisi long.
overview.short_usdnumberUSDSisi short.
overview.total_usdnumberUSDTotal.
overview.cntnumber—Jumlah.
byClassobject—Total likuidasi per kelas aset selama `range` yang diminta, mencakup semua kelas non-kripto terlepas dari filter `class`. kunci dinamis: stock,commodity,index,unknown,forex
byClass.{*}object—Total untuk satu kelas aset; kuncinya adalah nama kelas (`stock`, `commodity`, `index`, `forex`, `unknown`), masing-masing dengan `total_usd` dan `cnt`.
byClass.{*}.total_usdnumberUSDTotal.
byClass.{*}.cntnumber—Jumlah.
assetsarray—Aset.
assets[]object—Aset.
assets[].symbolstring—Simbol instrumen yang dinormalkan oleh CoinBoss (misalnya BTCUSDT).
assets[].dexnull—Bursa terdesentralisasi (deployer HIP-3 atau ID DEX).
assets[].dexesarray—Bursa terdesentralisasi. kosong pada sampel yang dipakai untuk menghasilkan tabel ini
assets[].dexes[]string—Bursa terdesentralisasi.
assets[].merged_fromarray—Sumber yang digabung ke baris ini.
assets[].merged_from[]string—Sumber yang digabung ke baris ini.
assets[].display_namestring|null—Nama tampilan.
assets[].long_usdnumberUSDSisi long.
assets[].short_usdnumberUSDSisi short.
assets[].total_usdnumberUSDTotal.
assets[].cntnumber—Jumlah.
largestarray—Entri terbesar.
largest[]object—Entri terbesar.
largest[].exchangestring—ID bursa, huruf kecil (misalnya `binance`).
largest[].symbolstring—Simbol instrumen yang dinormalkan oleh CoinBoss (misalnya BTCUSDT).
largest[].src_symbolstring—Simbol di sumber.
largest[].raw_symbolstring—Simbol persis seperti yang ditulis bursa.
largest[].dexstring|null—Bursa terdesentralisasi (deployer HIP-3 atau ID DEX).
largest[].sidestring—Sisi posisi yang dilikuidasi (`long` = posisi long dilikuidasi).
largest[].pricestring(decimal)—Harga terakhir dalam mata uang kuotasi (USD atau USDT kecuali dinyatakan lain).
largest[].qtystring(decimal)—Kuantitas.
largest[].value_usdstring(decimal)USDNosional likuidasi.
largest[].timestampnumbermsStempel waktu.
largest[].liq_userstring|null—Alamat akun yang dilikuidasi; hanya tersedia untuk likuidasi on-chain Hyperliquid, null untuk bursa lain.
chartarray—Deret grafik.
chart[]object—Deret grafik.
chart[].bucketnumbermsAwal bucket waktu.
chart[].sidestring—Sisi posisi yang dilikuidasi (`long` = posisi long dilikuidasi).
chart[].total_usdnumberUSDTotal.
sourcesarray—Sumber data.
sources[]object—Sumber data.
sources[].exchangestring—ID bursa, huruf kecil (misalnya `binance`).
sources[].dexstring|null—Bursa terdesentralisasi (deployer HIP-3 atau ID DEX).
sources[].total_usdnumberUSDTotal.
sources[].cntnumber—Jumlah.

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

Contoh respons

/api/liquidations/tradfi?class=stock&range=24h · Respons nyata yang direkam 2026-11-13 03:58:42 UTC. Array dan map yang panjang dipersingkat untuk tampilan: chart berisi 48 item; assets berisi 30 item; byClass berisi 5 item; largest berisi 10 item; sources berisi 11 item.

  • {
    • "success": true,
    • "range": "24h",
    • "class": "stock",
    • "overview": {
      • "long_usd": 57063780.89,
      • "short_usd": 35281288.2,
      • "total_usd": 92345069.09,
      • "cnt": 20306
      },
    • "byClass": {
      • "stock": { … 2 },
      • "commodity": { … 2 }
      },
    • "assets": [
      • { … 9 },
      • { … 9 }
      ],
    • "largest": [
      • { … 11 },
      • { … 11 }
      ],
    • "chart": [
      • { … 3 },
      • { … 3 }
      ],
    • "sources": [
      • { … 4 },
      • { … 4 }
      ]
    }

Detail

Autentikasi
Tidak ada. Endpoint publik.
Batas permintaan
1200 permintaan per menit per IP
Cache server
20s
Mikro-cache edge
10s
Frekuensi pembaruan
real-time (push WebSocket bursa); polling REST: okx setiap 15 s, gate setiap 25 s, htx setiap 5 min; batch fill node hyperliquid dimasukkan setiap 5 s
Jendela
parameter range: 1h | 4h | 12h | 24h (default 24h); bucket grafik 15 min jika range <= 4 h, selain itu 1 h
Sumber data
Likuidasi kontrak perpetual non-kripto (saham tertokenisasi, indeks, komoditas, valas) yang ditangkap oleh kolektor likuidasi bursa internal yang sama di 10 bursa (mis. binance, okx, hyperliquid, gate, bybit, bitget) dan dipisahkan oleh pengklasifikasi kelas aset.
Cakupan bursa
10 bursa yang teramati dalam 30 hari terakhir (binance, okx, hyperliquid, gate, bybit, bitget, lighter, aster, htx, bitfinex); kelas aset stock / index / commodity / forex (sebagian kecil diklasifikasikan 'unknown'); riwayat dimulai 2026-06-17
Paginasi
limit untuk daftar aset (default 30, maks 100)
Pengurutan
aset menurut total_usd, menurun
Satuan
USD notional (price x quantity) per liquidation order; timestamps in Unix ms; side LONG = long position liquidated, SHORT = short position liquidated
Metode
overview / byClass / per-asset totals = SUM(value_usd) by side; 10 largest orders; per-source (exchange) totals
Stempel waktu
Milidetik epoch Unix (UTC) kecuali deskripsi kolom menyatakan lain
Format respons
json
Stabilitas
Stabil

Status langsung

TersediaDiperiksa 2026-11-13 03:58:42 UTCHTTP 200101 msSkema sesuaiTitik data terbaru berusia 59m

Ketersediaan, 30 hari terakhir

99.76% dari 409 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/liquidations/tradfiTersedia
Parameter

string · default 24h — Time window.

string · default stock — Asset class; unknown value returns 400.

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

URL permintaanhttps://www.coinboss.com/api/liquidations/tradfi?range=24h&class=stock
Pilih endpoint lalu tekan “Kirim permintaan”. Respons, header, dan waktu tempuhnya akan muncul di sini.