Volume 24j—Open Interest—Likuidasi 24j$1.36BLong/Short 24j—Dominasi BTC—Dominasi ETH—
Aplikasi
Bahasa ▾
Rp IDR ▾
/api/hl/whale/:addr
GETTersedia

Detail satu whale Hyperliquid

Detail satu whale Hyperliquid (posisi dan aktivitas)

GET/api/hl/whale/:addr
Jika snapshot alamat yang tersimpan lebih lama dari 10 menit, permintaan akan memperbaruinya dari API publik Hyperliquid sebelum menjawab, sehingga panggilan pertama bisa lebih lambat.

Permintaan

Parameter kueri

NamaTipeWajibDefaultNilai yang diizinkanDeskripsi
addr pathstringWajib——Alamat 40 digit heksadesimal berawalan 0x; 400 jika formatnya salah (huruf kecil). Contoh: 0x5b5d51203a0f9079f8aeb098a6523a13f298c060

Parameter bertanda “path” merupakan bagian dari URL.

Contoh permintaan

curl -s "https://www.coinboss.com/api/hl/whale/0x5b5d51203a0f9079f8aeb098a6523a13f298c060"

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 }`.
updatednumbermsWaktu data terakhir diperbarui.
addressstring—Alamat on-chain.
trackedboolean—True jika alamat ada dalam kumpulan whale yang dilacak.
labelsarray—Label.
labels[]object—Label.
labels[].labelstring—Label.
labels[].typestring—Tipe.
profileobject—Catatan alamat di kumpulan tersebut; null jika alamat tidak dilacak.
profile.firstSeennumbermsPertama kali alamat tercatat dalam fill besar atau likuidasi.
profile.lastActivenumbermsTerakhir kali alamat terlihat dalam fill besar atau likuidasi.
profile.totalVolumeUsdnumberUSDNosional kumulatif fill besar alamat yang tercatat sejak `firstSeen`; bukan seluruh volume perdagangannya.
profile.tradeCountnumbercountJumlah fill besar yang tercatat untuk alamat sejak `firstSeen`.
profile.maxFillUsdnumberUSDFill tunggal terbesar yang tercatat untuk alamat tersebut.
profile.liqCountnumbercountLikuidasi alamat ini di Hyperliquid yang tercatat sejak alamat tersebut dilacak.
profile.sourcestring—Asal nilai tersebut.
profile.accountValuenumberUSDEkuitas akun.
profile.totalUpnlnumberUSDTotal PnL yang belum direalisasi.
profile.totalPosValuenumberUSDJumlah nilai posisi semua posisi terbuka pada polling terakhir (`posPolledAt`); null jika belum pernah di-polling.
profile.posPolledAtnumbermsWaktu posisi terakhir di-polling.
positionsarray—Posisi terbuka.
positions[]object—Posisi terbuka.
positions[].coinstring—Simbol koin, huruf besar (misalnya BTC).
positions[].sidestring—`long` / `short` atau `buy` / `sell`.
positions[].szinumber—Ukuran posisi bertanda dalam koin (negatif = short).
positions[].entryPxnumberUSDHarga masuk rata-rata.
positions[].positionValuenumberUSDNosional posisi.
positions[].unrealizedPnlnumberUSDLaba dan rugi yang belum direalisasi.
positions[].roenumberfractionPnL yang belum direalisasi dibagi margin posisi, sebagaimana dilaporkan Hyperliquid (0.13 = 13 %); null jika nilainya nol atau tidak ada.
positions[].leveragenumber—Leverage posisi.
positions[].leverageTypestring—Mode margin posisi: `cross` atau `isolated`.
positions[].marginUsednumberUSDMargin yang dipakai posisi.
positions[].liquidationPxnumber|nullUSDEstimasi harga likuidasi.
positions[].snapshotTsnumbermsWaktu snapshot posisi.
recentLiquidationsarray—Hingga 50 likuidasi terbaru alamat ini di Hyperliquid, dari yang terbaru; kosong jika tidak ada yang tercatat. kosong pada sampel yang dipakai untuk menghasilkan tabel ini
statsobject—Statistik trading yang dihitung dari fill perpetual terbaru alamat tersebut (paling banyak 2.000); null sampai statistik itu dihitung.
stats.windowDaysnumberdaysJumlah hari antara fill terlama dan terbaru yang dianalisis (minimum 1).
stats.fillsAnalyzednumbercountJumlah fill yang dianalisis: fill terbaru yang dikembalikan Hyperliquid untuk alamat tersebut, paling banyak 2.000.
stats.closedTradesnumbercountEvent penutupan di antara fill perpetual yang dianalisis (fill dengan closed PnL bukan nol, dikelompokkan menurut transaksi dan koin).
stats.winsnumbercountEvent penutupan dengan closed PnL positif.
stats.winRatenumberfraction`wins` ÷ `closedTrades` (0.6 = 60 %); null jika tidak ada event penutupan.
stats.realizedPnlnumberUSDJumlah closed PnL atas fill yang dianalisis, sebelum biaya.
stats.feesPaidnumberUSDJumlah biaya perdagangan atas fill perpetual yang dianalisis.
stats.volumeUsdnumberUSDJumlah harga × ukuran atas fill perpetual yang dianalisis.
stats.maxDrawdownnumberUSDPenurunan terbesar dari puncak ke lembah pada closed PnL kumulatif di dalam fill yang dianalisis; null jika tidak ada drawdown.
stats.roinumberfractionImbal hasil 30 hari akun dari papan peringkat milik Hyperliquid sendiri (0.1 = 10 %); null jika alamat tidak ada di papan peringkat tersebut.
stats.topCoinsarray—Koin terbesar.
stats.topCoins[]string—Koin terbesar.
stats.computedAtnumbermsStempel waktu.

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

Contoh respons

/api/hl/whale/0x5b5d51203a0f9079f8aeb098a6523a13f298c060 · Respons nyata yang direkam 2026-11-13 03:58:41 UTC. Array dan map yang panjang dipersingkat untuk tampilan: labels berisi 3 item; positions berisi 23 item.

  • {
    • "success": true,
    • "updated": 1794542321546,
    • "address": "0x5b5d51203a0f9079f8aeb098a6523a13f298c060",
    • "tracked": true,
    • "labels": [
      • { … 2 },
      • { … 2 }
      ],
    • "profile": {
      • "firstSeen": 1784647213853,
      • "lastActive": 1794431032742,
      • "totalVolumeUsd": 1925599.62,
      • "tradeCount": 21,
      • "maxFillUsd": 207800.94,
      • "liqCount": 0,
      • "source": "bigfill",
      • "accountValue": 72162095.74,
      • "totalUpnl": 69508245.45,
      • "totalPosValue": 332670116.98,
      • "posPolledAt": 1794542171319
      },
    • "positions": [
      • { … 12 },
      • { … 12 }
      ],
    • "recentLiquidations": [],
    • "stats": {
      • "windowDays": 1,
      • "fillsAnalyzed": 2000,
      • "closedTrades": 1262,
      • "wins": 772,
      • "winRate": 0.6117,
      • "realizedPnl": 44221.53,
      • "feesPaid": 164.6835,
      • "volumeUsd": 1047900.19,
      • "maxDrawdown": 2774.11,
      • "roi": 0.812723,
      • "topCoins": [ … 5 ],
      • "computedAt": 1793024816450
      }
    }

Detail

Autentikasi
Tidak ada. Endpoint publik.
Batas permintaan
1200 permintaan per menit per IP
Cache server
20s
Mikro-cache edge
10s
Frekuensi pembaruan
posisi setiap 5 min untuk alamat teratas, diperbarui saat diminta jika lebih lama dari 10 min; cache API 20 s
Jendela
posisi terbaru; riwayat likuidasi sebagaimana tersimpan
Sumber data
Profil satu alamat Hyperliquid: posisi (di-polling dari API info resmi, diperbarui saat diminta jika usang), riwayat likuidasi dari node milik kami, statistik, dan label.
Cakupan bursa
Alamat mana pun; data lebih kaya untuk alamat yang sudah ada dalam kumpulan yang dilacak
Paginasi
tidak ada
Satuan
USD
Stempel waktu
Milidetik epoch Unix (UTC) kecuali deskripsi kolom menyatakan lain
Format respons
json
Stabilitas
Stabil

Status langsung

TersediaDiperiksa 2026-11-13 03:58:41 UTCHTTP 2004 msSkema sesuaiTitik data terbaru berusia 0s

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/hl/whale/:addrTersedia
Parameter

string — 0x-prefixed 40-hex address; 400 on bad format (lowercase).

URL permintaanhttps://www.coinboss.com/api/hl/whale/0x5b5d51203a0f9079f8aeb098a6523a13f298c060
Pilih endpoint lalu tekan “Kirim permintaan”. Respons, header, dan waktu tempuhnya akan muncul di sini.