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

Peta likuidasi

Peta likuidasi (estimasi ukuran likuidasi per level harga dan leverage)

GET/api/liq-map

Permintaan

Parameter kueri

NamaTipeWajibDefaultNilai yang diizinkanDeskripsi
symbolstringOpsionalBTC—Simbol koin; 404 jika tidak ada data. Contoh: BTC
rangestringOpsional1d1d, 7dJendela waktu. Contoh: 1d

Contoh permintaan

curl -s "https://www.coinboss.com/api/liq-map?symbol=BTC&range=1d"

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
symbolstring—Simbol instrumen yang dinormalkan oleh CoinBoss (misalnya BTCUSDT).
rangestring—Jendela yang diminta.
updatedAtnumbermsWaktu data terakhir diperbarui.
currentPricenumber—Harga saat ini.
binWidthnumberUSDLebar harga satu bin: sumbu mencakup ±10 % (`1d`) atau ±18 % (`7d`) di sekitar `currentPrice`, dibagi menjadi 200 bin.
leveragesarray—Tingkatan leverage tempat model mendistribusikan posisi, menaik (10, 25, 50, 100).
leverages[]numberxKelipatan leverage satu tingkatan; dipakai sebagai kunci di dalam `bins[].tiers`.
binsarray—200 bin harga pada peta, diurutkan menurut harga secara menaik; estimasi model, bukan data bursa.
bins[]object—Satu bin harga: `price` tengah, `side` (`long` di bawah harga saat ini, `short` pada atau di atasnya), `tiers` per leverage, dan `total`-nya.
bins[].pricenumber—Harga terakhir dalam mata uang kuotasi (USD atau USDT kecuali dinyatakan lain).
bins[].sidestring—`long` / `short` atau `buy` / `sell`.
bins[].tiersobject—Tingkatan ukuran.
bins[].tiers.10numberUSDNosional likuidasi hasil pemodelan di bin harga ini dari posisi yang dibuka dengan leverage 10x; kuncinya tidak ada jika jumlahnya nol. bisa tidak ada
bins[].totalnumber—Total.
bins[].tiers.25numberUSDNosional likuidasi hasil pemodelan di bin harga ini dari posisi yang dibuka dengan leverage 25x; kuncinya tidak ada jika jumlahnya nol. bisa tidak ada
cumarray—Kurva kumulatif yang diselaraskan indeks demi indeks dengan `bins`.
cum[]numberUSDNosional likuidasi hasil pemodelan yang terakumulasi dari harga saat ini hingga bin ini (ke bawah untuk bin di bawahnya, ke atas untuk bin di atasnya).
maxBinnumberUSD`bins[].total` terbesar pada peta, dapat dipakai untuk menskalakan sumbu grafik.
totalLongnumber—Total long.
totalShortnumber—Total short.
actualLiq24hnumberUSDNosional yang benar-benar dilikuidasi pada koin tersebut selama 24 jam terakhir (long + short, order likuidasi yang tercatat), sebagai pembanding model.

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

Contoh respons

/api/liq-map?symbol=BTC&range=1d · Respons nyata yang direkam 2026-11-13 03:52:47 UTC. Array dan map yang panjang dipersingkat untuk tampilan: cum berisi 200 item; bins berisi 200 item.

  • {
    • "symbol": "BTC",
    • "range": "1d",
    • "updatedAt": 1794541891278,
    • "currentPrice": 69059.1,
    • "binWidth": 69.0591,
    • "leverages": [
      • 10,
      • 25,
      • 50,
      • 100
      ],
    • "bins": [
      • { … 4 },
      • { … 4 }
      ],
    • "cum": [
      • 181751104,
      • 181751104,
      • 181751104,
      • 181751104,
      • 165607035,
      • 165607035,
      • 165607035,
      • 165607035
      ],
    • "maxBin": 22547138,
    • "totalLong": 181751104,
    • "totalShort": 232458129,
    • "actualLiq24h": 745954159
    }

Sampel terverifikasi

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

ParameterHTTPLatensiHasil
range=1d&symbol=ETH2001 msLolos
range=1d&symbol=SOL2001 msLolos

Diperiksa 2026-11-13 03:28:04 UTC

Detail

Autentikasi
Tidak ada. Endpoint publik.
Batas permintaan
1200 permintaan per menit per IP
Cache server
60s
Mikro-cache edge
10s
Frekuensi pembaruan
setiap 5 min untuk 100 koin teratas; koin peringkat 101-300 diperbarui dalam 5 batch bergiliran (sekitar setiap 25 min)
Jendela
parameter range: 1d | 7d (posisi diasumsikan dibuka dalam 1 atau 7 hari terakhir); snapshot model terbaru
Sumber data
Estimasi model yang dihitung sendiri dari K-line futures per jam milik CoinBoss (binance, okx sebagai cadangan), riwayat open interest agregat, dan likuidasi yang dikumpulkan.
Cakupan bursa
hingga 300 koin kripto yang diperingkat menurut volume nosional futures, dengan syarat >= 30 peristiwa likuidasi dalam 7 hari terakhir; saham tertokenisasi, komoditas, valas, dan indeks dikecualikan; estimasi adalah keluaran model, bukan level likuidasi yang dilaporkan bursa
Satuan
estimated liquidation notional in USD per price level; prices in USD; timestamps in Unix ms
Metode
each 1 h candle opens notional proportional to volume x close (boosted by OI increase), spread over leverage tiers; long liq price ~ P x (1 - 1/L + MMR), short ~ P x (1 + 1/L - MMR); levels swept by later candles are cleared; output = cumulative long/short liquidation notional by price and leverage tier
Stempel waktu
Milidetik epoch Unix (UTC) kecuali deskripsi kolom menyatakan lain
Format respons
json
Stabilitas
Stabil

Status langsung

TersediaDiperiksa 2026-11-13 03:52:47 UTCHTTP 2002 msSkema sesuaiTitik data terbaru berusia 76s

Ketersediaan, 30 hari terakhir

100% 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/liq-mapTersedia
Parameter

string · default BTC — Coin symbol; 404 when no data.

string · default 1d — Time window.

URL permintaanhttps://www.coinboss.com/api/liq-map?symbol=BTC&range=1d
Pilih endpoint lalu tekan “Kirim permintaan”. Respons, header, dan waktu tempuhnya akan muncul di sini.