Ikhtisar likuidasi untuk satu simbol TradFi
Ikhtisar likuidasi untuk satu simbol TradFi
/api/liquidations/tradfi-symbolPermintaan
Parameter kueri
| Nama | Tipe | Wajib | Default | Nilai yang diizinkan | Deskripsi |
|---|---|---|---|---|---|
| symbol | string | Wajib | — | — | Simbol TradFi (alias diterima); 400 jika tidak dapat dikenali; 404 jika tidak ada riwayat likuidasi. Contoh: SNDK |
Contoh permintaan
curl -s "https://www.coinboss.com/api/liquidations/tradfi-symbol?symbol=SNDK"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.
| Kolom | Tipe | Satuan | Deskripsi |
|---|---|---|---|
| success | boolean | — | true jika permintaan berhasil. Jika gagal, body-nya adalah `{ success: false, code, error, request_id }`. |
| now | number | ms | Waktu server saat respons disusun. |
| symbol | string | — | Simbol instrumen yang dinormalkan oleh CoinBoss (misalnya BTCUSDT). |
| is_alias_input | boolean | — | True jika `symbol` yang diminta adalah alias yang dipetakan ke simbol kanonis yang berbeda. |
| canonical_symbol | string | — | Simbol kanonis tempat semua alias aset dasar ini diagregasi; nilainya sama dengan `symbol`. |
| merged_from | array | — | Sumber yang digabung ke baris ini. |
| merged_from[] | string | — | Sumber yang digabung ke baris ini. |
| display_name | string | — | Nama tampilan. |
| contract_name | string | — | Nama yang tercatat untuk kontrak tertokenisasi aset dasar ini; string kosong jika tidak ada yang diketahui. |
| contract_type | string | — | `perpetual` atau `delivery`. |
| asset_class | string | — | `stock`, `index`, `commodity`, atau `forex`. |
| subclasses | array | — | Tag subkelas aset berbeda yang ditemukan pada catatan likuidasi simbol ini. |
| subclasses[] | string | — | Satu tag subkelas aset, mis. `common_stock` atau `unspecified`. |
| exchanges | array | — | Bursa. |
| exchanges[] | string | — | Bursa. |
| dexes | array | — | Bursa terdesentralisasi. |
| dexes[] | string | — | Bursa terdesentralisasi. |
| first_ts | number | ms | Stempel waktu. |
| last_ts | number | ms | Stempel waktu. |
| cnt_30d | number | count | Jumlah catatan likuidasi untuk simbol ini selama 30 hari terakhir. |
| tier | string | — | Tingkatan aktivitas dari `cnt_30d`: `T1` ≥ 1000, `T2` 200–999, `T3` 50–199, `T4` 10–49, `none` di bawah 10. |
| min_cnt_30d | number | count | Jumlah likuidasi 30 hari minimum (10) yang diperlukan sebuah simbol agar tercantum di direktori simbol. |
| overview | object | — | Blok ikhtisar. kunci dinamis: 1h,4h,12h,24h,7d,30d |
| overview.{*} | object | — | Blok ikhtisar. |
| overview.{*}.long_usd | number | USD | Sisi long. |
| overview.{*}.short_usd | number | USD | Sisi short. |
| overview.{*}.total_usd | number | USD | Total. |
| overview.{*}.cnt | number | — | Jumlah. |
| class_evidence | array | — | Hingga 3 bukti yang paling sering muncul di balik penetapan kelas aset simbol ini, dari yang paling sering. |
| class_evidence[] | object | — | Satu entri bukti beserta `source`, string `evidence`, dan jumlah catatan (`cnt`) yang membawanya. |
| class_evidence[].source | string | — | Asal nilai tersebut. |
| class_evidence[].evidence | string | — | String bukti klasifikasi mentah yang tercatat bersama likuidasi, mis. `desc:common_stock`. |
| class_evidence[].cnt | number | — | Jumlah. |
Dihasilkan 2026-11-11 23:00 UTC dari 1 respons nyata.
Contoh respons
/api/liquidations/tradfi-symbol?symbol=SNDK · Respons nyata yang direkam 2026-11-13 04:03:12 UTC. Array dan map yang panjang dipersingkat untuk tampilan: overview berisi 6 item; exchanges berisi 9 item.
- "success"true
- "now"1794542592473
- "symbol""SNDK"
- "is_alias_input"false
- "canonical_symbol""SNDK"
- "merged_from"
- "SNDK"
- "display_name""Sandisk"
- "contract_name""Sandisk"
- "contract_type""stock"
- "asset_class""stock"
- "subclasses"
- "common_stock"
- "unspecified"
- "exchanges"
- "aster"
- "binance"
- "bitget"
- "bybit"
- "gate"
- "htx"
- "hyperliquid"
- "lighter"
- "dexes"
- "io"
- "xyz"
- "first_ts"1781766257143
- "last_ts"1794542560206
- "cnt_30d"55504
- "tier""T1"
- "min_cnt_30d"10
- "overview"
- "1h"
- "4h"
- "class_evidence"
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
- jendela bergulir 1 h, 4 h, 12 h, 24 h, 7 d, 30 d untuk satu simbol
- 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
- Satuan
- USD notional (price x quantity) per liquidation order; timestamps in Unix ms; side LONG = long position liquidated, SHORT = short position liquidated
- Metode
- per window: long_usd, short_usd, total_usd = SUM(value_usd), cnt; tier from the 30-day event count (T1 >= 1000, T2 200-999, T3 50-199, T4 10-49, none < 10)
- Stempel waktu
- Milidetik epoch Unix (UTC) kecuali deskripsi kolom menyatakan lain
- Format respons
- json
- Stabilitas
- Stabil
Status langsung
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 →
| Kode | HTTP | Arti | Tindakan |
|---|---|---|---|
| INVALID_PARAM | 400 | Parameter wajib tidak ada atau suatu nilai tidak diterima. `param` menyebutkan nama parameternya jika diketahui. | Jangan mengulang tanpa perubahan; perbaiki permintaannya. |
| UNAUTHORIZED | 401 | Header `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. |
| FORBIDDEN | 403 | Rute ini bukan bagian dari API publik (internal atau khusus akun). | Jangan mengulang. |
| NOT_FOUND | 404 | Rute tidak dikenal, atau koin / bursa / dana yang diminta tidak ada. | Jangan mengulang; periksa path dan pengenal terhadap katalog. |
| RATE_LIMITED | 429 | Jumlah permintaan melebihi batas per menit. `Retry-After` memberikan jumlah detik untuk menunggu. | Tunggu selama `Retry-After`, lalu ulangi dengan backoff. |
| INTERNAL | 500 | Error 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_FAILED | 503 | Sumber 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. |
| UNAVAILABLE | 501 / 503 | Dataset 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_FAILED | 200 | Beberapa endpoint lama menjawab HTTP 200 dengan `success: false`. Selalu periksa `success`, bukan hanya status HTTP. | Bergantung pada pesannya; perlakukan sebagai permintaan yang gagal. |
Coba
/api/liquidations/tradfi-symbolTersediastring — TradFi symbol (aliases accepted); 400 if it cannot be resolved; 404 when no liquidation history.
https://www.coinboss.com/api/liquidations/tradfi-symbol?symbol=SNDKLainnya di kategori ini
- Ikhtisar likuidasi kontrak perpetual TradFi /api/liquidations/tradfi
- Daftar simbol TradFi yang mengalami likuidasi dalam jendela /api/liquidations/tradfi-asset-list
- Peringkat likuidasi per simbol untuk kontrak perpetual TradFi /api/liquidations/tradfi-assets
- Pembagian likuidasi per bursa untuk kontrak perpetual TradFi /api/liquidations/tradfi-exchanges
- Feed likuidasi kontrak perpetual TradFi /api/liquidations/tradfi-feed
- Order likuidasi terbesar pada kontrak perpetual TradFi /api/liquidations/tradfi-largest
- Total likuidasi multi-jendela untuk kontrak perpetual TradFi /api/liquidations/tradfi-overview
- Ikhtisar likuidasi untuk satu simbol TradFi /api/liquidations/tradfi-symbol
- Deret waktu likuidasi untuk satu simbol TradFi /api/liquidations/tradfi-symbol-chart
- Pembagian likuidasi per bursa untuk satu simbol TradFi /api/liquidations/tradfi-symbol-exchanges
- Likuidasi terbesar untuk satu simbol TradFi /api/liquidations/tradfi-symbol-largest
- Simbol TradFi yang memiliki riwayat likuidasi /api/liquidations/tradfi-symbols
- Tabel likuidasi TradFi /api/liquidations/tradfi-table
- Deret waktu total likuidasi kontrak perpetual TradFi /api/liquidations/tradfi-total-chart
- Kuotasi kontrak pre-IPO /api/preipo/list
- Daftar aset dasar saham /api/stock-detail-list
- Detail aset dasar saham /api/stock-detail/:underlying
- Daftar instrumen saham /api/stocks/list
- Kontrak perpetual saham / saham tertokenisasi yang terdaftar di bursa /api/tabs17/exchange-stocks
- Kuotasi saham terkait kripto /api/tabs17/stocks