/api/hl/tier/:slug
GETSebagian

Detail tingkatan Hyperliquid

Detail tingkatan Hyperliquid (ringkasan, posisi per koin, risiko likuidasi, pembukaan posisi terbaru)

GET/api/hl/tier/:slug
Cakupan sebagian. `liqRisk` dan `actions` bisa berupa array kosong untuk tingkatan dengan sangat sedikit dompet.

Permintaan

Parameter kueri

NamaTipeWajibDefaultNilai yang diizinkanDeskripsi
slug pathstringWajib—stardust, meteor, asteroid, comet, planet, star, supernova, galaxySlug tingkatan; 404 jika tidak dikenal. Contoh: galaxy

Parameter bertanda “path” merupakan bagian dari URL.

Contoh permintaan

curl -s "https://www.coinboss.com/api/hl/tier/galaxy"

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.
tierobject—Tingkatan ukuran dompet.
tier.bucketnumbermsAwal bucket waktu.
tier.slugstring—ID tingkatan.
tier.minnumber—Minimum.
tier.maxnull—Maksimum.
networkobject—Jumlah dompet untung / rugi di tingkatan ini atas semua alamat di papan peringkat Hyperliquid, per jendela PnL; null jika tidak ada snapshot.
network.tsnumbermsStempel waktu.
network.windowsobject—Nilai per jendela. kunci dinamis: allTime,day,month,week
network.windows.{*}object—Nilai per jendela.
network.windows.{*}.walletsnumber—Jumlah dompet.
network.windows.{*}.profitnumber—Laba.
network.windows.{*}.lossnumber—Rugi.
network.windows.{*}.flatnumber—Jumlah atau nilai yang datar (tidak berubah).
network.windows.{*}.profitUsdnumberUSDJumlah laba.
network.windows.{*}.lossUsdnumberUSDJumlah rugi.
poolobject—Angka yang terbatas pada alamat whale terlacak yang nilai akunnya masuk tingkatan ini, bukan seluruh jaringan.
pool.trackednumbercountAlamat whale terlacak yang nilai akunnya masuk tingkatan ini.
pool.holdersnumbercountDi antaranya, alamat dengan setidaknya satu posisi terbuka.
pool.longUsdnumberUSDNosional long.
pool.shortUsdnumberUSDNosional short.
pool.upnlWinAddrsnumbercountAlamat dengan setidaknya satu posisi yang untung secara belum terealisasi; satu alamat dapat juga dihitung dalam `upnlLoseAddrs`.
pool.upnlLoseAddrsnumbercountAlamat dengan setidaknya satu posisi yang rugi secara belum terealisasi; satu alamat dapat juga dihitung dalam `upnlWinAddrs`.
coinRankarray—20 koin teratas menurut total nilai posisi yang dipegang alamat terlacak di tingkatan ini.
coinRank[]object—Satu koin beserta nilai posisi long, short, dan totalnya dalam USD.
coinRank[].coinstring—Simbol koin, huruf besar (misalnya BTC).
coinRank[].longUsdnumberUSDNosional long.
coinRank[].shortUsdnumberUSDNosional short.
coinRank[].totalUsdnumberUSDTotal.
liqRiskarray—Hingga 15 koin yang diperingkat menurut nilai posisi dan harga mark-nya berada dalam jarak 10 % dari harga likuidasi; kosong jika tidak ada. kosong pada sampel yang dipakai untuk menghasilkan tabel ini
actionsarray—40 fill pembukaan posisi terbaru (`open_long` / `open_short`) oleh alamat terlacak di tingkatan ini, dari yang terbaru. kosong pada sampel yang dipakai untuk menghasilkan tabel ini

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

Contoh respons

/api/hl/tier/galaxy · Respons nyata yang direkam 2026-11-13 04:03:07 UTC. Array dan map yang panjang dipersingkat untuk tampilan: coinRank berisi 20 item; network.windows berisi 4 item.

  • {
    • "success": true,
    • "updated": 1794542587304,
    • "tier": {
      • "bucket": 7,
      • "slug": "galaxy",
      • "min": 100000000,
      • "max": null
      },
    • "network": {
      • "ts": 1794542435518,
      • "windows": { … 2 }
      },
    • "pool": {
      • "tracked": 1,
      • "holders": 1,
      • "longUsd": 844581.06,
      • "shortUsd": 273471757.4,
      • "upnlWinAddrs": 1,
      • "upnlLoseAddrs": 1
      },
    • "coinRank": [
      • { … 4 },
      • { … 4 }
      ],
    • "liqRisk": [],
    • "actions": []
    }

Detail

Autentikasi
Tidak ada. Endpoint publik.
Batas permintaan
1200 permintaan per menit per IP
Cache server
60s
Mikro-cache edge
10s
Frekuensi pembaruan
bucket papan peringkat setiap 15 min; posisi setiap 5 min; aksi setiap 15 s; cache API 60 s
Jendela
snapshot terbaru; 40 aksi pembukaan posisi terakhir
Sumber data
Profil satu tingkatan ukuran akun di Hyperliquid: jumlah dompet dan PnL dari papan peringkat resmi, ditambah kepemilikan, risiko likuidasi, dan pembukaan posisi terkini dari alamat whale yang dilacak pada tingkatan tersebut.
Cakupan bursa
slug = stardust | meteor | asteroid | comet | planet | star | supernova | galaxy; blok network = dompet papan peringkat, blok pool = hanya kumpulan whale yang dilacak
Paginasi
tidak ada
Satuan
USD; counts
Metode
liqRisk = notional of positions with |mark - liquidation price| / mark <= 10%
Stempel waktu
Milidetik epoch Unix (UTC) kecuali deskripsi kolom menyatakan lain
Format respons
json
Stabilitas
Stabil

Status langsung

SebagianDiperiksa 2026-11-13 04:03:07 UTCHTTP 200188 msSkema sesuaiTitik data terbaru berusia 0s

`liqRisk` dan `actions` bisa berupa array kosong untuk tingkatan dengan sangat sedikit dompet.

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 →

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/tier/:slugSebagian
Parameter

string — Tier slug; 404 if unknown.

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