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

Ringkasan posisi Hyperliquid

Ringkasan posisi Hyperliquid (lingkup kumpulan whale)

GET/api/hl/position-summary

Permintaan

Parameter kueri

NamaTipeWajibDefaultNilai yang diizinkanDeskripsi
scopestringOpsionalwhale_poolwhale_pool, all_networkLingkup. Contoh: whale_pool

Contoh permintaan

curl -s "https://www.coinboss.com/api/hl/position-summary?scope=whale_pool"

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.
scopestring—Himpunan alamat ringkasan: `whale_pool` (alamat whale yang dilacak). `all_network` diterima tetapi saat ini tidak mengembalikan snapshot.
snapshotobject—Agregat terbaru semua posisi whale yang dilacak (snapshot disimpan setiap 5 menit); null jika tidak ada.
snapshot.tsnumbermsStempel waktu.
snapshot.addrCountnumbercountAlamat terlacak yang berbeda dengan setidaknya satu posisi terbuka.
snapshot.longAddrsnumber—Jumlah alamat yang long.
snapshot.shortAddrsnumber—Jumlah alamat yang short.
snapshot.longValuenumberUSDNosional long.
snapshot.shortValuenumberUSDNosional short.
snapshot.longMarginnumberUSDMargin yang dipakai posisi long.
snapshot.shortMarginnumberUSDMargin yang dipakai posisi short.
snapshot.longUpnlnumberUSDJumlah PnL yang belum direalisasi dari posisi long.
snapshot.shortUpnlnumberUSDJumlah PnL yang belum direalisasi dari posisi short.
snapshot.longFundingnumberUSDJumlah funding sejak posisi dibuka atas posisi long, mengikuti konvensi tanda Hyperliquid (positif = dibayar, negatif = diterima).
snapshot.shortFundingnumberUSDJumlah funding sejak posisi dibuka atas posisi short, mengikuti konvensi tanda Hyperliquid (positif = dibayar, negatif = diterima).
prev24hobject—Snapshot tersimpan terbaru yang setidaknya 24 jam lebih lama daripada `snapshot`, sebagai pembanding; null jika tidak ada.
prev24h.tsnumbermsStempel waktu.
prev24h.addrCountnumbercountAlamat terlacak yang berbeda dengan setidaknya satu posisi terbuka pada snapshot yang lebih awal.
prev24h.longAddrsnumber—Jumlah alamat yang long.
prev24h.shortAddrsnumber—Jumlah alamat yang short.
prev24h.longValuenumberUSDNosional long.
prev24h.shortValuenumberUSDNosional short.
prev24h.longMarginnumberUSDMargin yang dipakai posisi long pada snapshot yang lebih awal.
prev24h.shortMarginnumberUSDMargin yang dipakai posisi short pada snapshot yang lebih awal.
prev24h.longUpnlnumberUSDJumlah PnL yang belum direalisasi dari posisi long pada snapshot yang lebih awal.
prev24h.shortUpnlnumberUSDJumlah PnL yang belum direalisasi dari posisi short pada snapshot yang lebih awal.
prev24h.longFundingnumberUSDJumlah funding sejak posisi dibuka atas posisi long pada snapshot yang lebih awal (positif = dibayar).
prev24h.shortFundingnumberUSDJumlah funding sejak posisi dibuka atas posisi short pada snapshot yang lebih awal (positif = dibayar).

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

Contoh respons

/api/hl/position-summary?scope=whale_pool · Respons nyata yang direkam 2026-11-13 03:53:08 UTC.

  • {
    • "success": true,
    • "updated": 1794541988572,
    • "scope": "whale_pool",
    • "snapshot": {
      • "ts": 1794541833226,
      • "addrCount": 1707,
      • "longAddrs": 1250,
      • "shortAddrs": 761,
      • "longValue": 2317647288.5,
      • "shortValue": 2668492906.07,
      • "longMargin": 266041962.88,
      • "shortMargin": 344054602.74,
      • "longUpnl": -225343054.98,
      • "shortUpnl": 319405247.39,
      • "longFunding": 41171557.592659,
      • "shortFunding": -92766854.054105
      },
    • "prev24h": {
      • "ts": 1794455433182,
      • "addrCount": 1731,
      • "longAddrs": 1282,
      • "shortAddrs": 754,
      • "longValue": 2508207564.38,
      • "shortValue": 2900101148.16,
      • "longMargin": 290106695.23,
      • "shortMargin": 372506105.81,
      • "longUpnl": -199152142.42,
      • "shortUpnl": 256448952.11,
      • "longFunding": 41667716.017602,
      • "shortFunding": -92718942.253169
      }
    }

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 (disimpan 90 hari); cache API 60 s
Jendela
snapshot terbaru vs snapshot 24h sebelumnya
Sumber data
Eksposur long/short agregat dari kumpulan whale Hyperliquid yang dilacak, di-snapshot sendiri.
Cakupan bursa
kumpulan whale yang dilacak (alamat yang pernah melakukan satu fill >= 50.000 USD, pernah dilikuidasi, atau menjalankan vault); bukan seluruh jaringan
Paginasi
tidak ada
Satuan
USD; counts
Stempel waktu
Milidetik epoch Unix (UTC) kecuali deskripsi kolom menyatakan lain
Format respons
json
Stabilitas
Stabil

Status langsung

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

Ketersediaan, 30 hari terakhir

100% dari 408 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/position-summaryTersedia
Parameter

string · default whale_pool — Scope.

URL permintaanhttps://www.coinboss.com/api/hl/position-summary?scope=whale_pool
Pilih endpoint lalu tekan “Kirim permintaan”. Respons, header, dan waktu tempuhnya akan muncul di sini.