/api/hl/vault-profile/:addr
GETSebagian

Profil vault Hyperliquid

Profil vault Hyperliquid (posisi, performa)

GET/api/hl/vault-profile/:addr
Cakupan sebagian. Vault induk (seperti HLP) memegang posisi di vault anak, sehingga `positions`, `topCoins`, dan `daily` bisa kosong untuk vault tersebut.

Permintaan

Parameter kueri

NamaTipeWajibDefaultNilai yang diizinkanDeskripsi
addr pathstringWajib——Alamat 40 digit heksadesimal berawalan 0x; 400 jika formatnya salah. Contoh: 0xdfc24b077bc1425ad1dea75bcb6f8158e10df303

Parameter bertanda “path” merupakan bagian dari URL.

Contoh permintaan

curl -s "https://www.coinboss.com/api/hl/vault-profile/0xdfc24b077bc1425ad1dea75bcb6f8158e10df303"

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.
vaultobject—Catatan direktori vault beserta total posisi terbarunya; null jika alamat bukan vault yang dikenal.
vault.namestring—Nama.
vault.leaderstring—Alamat leader vault.
vault.tvlnumberUSDTotal nilai terkunci di vault.
vault.aprnumber—Imbal hasil vault yang disetahunkan.
vault.isClosedboolean—True jika Hyperliquid mencantumkan vault sebagai ditutup.
vault.relTypestring—Jenis hubungan dari direktori vault Hyperliquid: `parent`, `child`, atau `normal`.
vault.parentAddressnull—Alamat vault induk jika ini adalah vault anak; selain itu null.
vault.createTimenumbermsStempel waktu.
vault.accountValuenumberUSDEkuitas akun.
vault.positionValuenumberUSDNosional posisi.
vault.longValuenumberUSDNosional long.
vault.shortValuenumberUSDNosional short.
vault.totalUpnlnumberUSDTotal PnL yang belum direalisasi.
vault.posPolledAtnumbermsWaktu posisi terakhir di-polling.
vault.syncedAtnumbermsStempel waktu.
positionsarray—Posisi terbuka. kosong pada sampel yang dipakai untuk menghasilkan tabel ini
stylenull—Profil gaya trading yang disusun dari fill vault pada hari-hari yang memiliki data dalam 30 hari terakhir (volume, pangsa taker, perputaran); null jika tidak ada fill yang tercatat.
topCoinsarray—Koin terbesar. kosong pada sampel yang dipakai untuk menghasilkan tabel ini
dailyarray—Nilai harian. kosong pada sampel yang dipakai untuk menghasilkan tabel ini

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

Contoh respons

/api/hl/vault-profile/0xdfc24b077bc1425ad1dea75bcb6f8158e10df303 · Respons nyata yang direkam 2026-11-13 04:03:07 UTC.

  • {
    • "success": true,
    • "updated": 1794542587806,
    • "address": "0xdfc24b077bc1425ad1dea75bcb6f8158e10df303",
    • "vault": {
      • "name": "Hyperliquidity Provider (HLP)",
      • "leader": "0x677d831aef5328190852e24f13c46cac05f984e7",
      • "tvl": 150199834.32,
      • "apr": 0.226572,
      • "isClosed": false,
      • "relType": "parent",
      • "parentAddress": null,
      • "createTime": 1683243596849,
      • "accountValue": 10173088.31,
      • "positionValue": 0,
      • "longValue": 0,
      • "shortValue": 0,
      • "totalUpnl": 0,
      • "posPolledAt": 1794542471336,
      • "syncedAt": 1794542172182
      },
    • "positions": [],
    • "style": null,
    • "topCoins": [],
    • "daily": []
    }

Detail

Autentikasi
Tidak ada. Endpoint publik.
Batas permintaan
1200 permintaan per menit per IP
Cache server
30s
Mikro-cache edge
10s
Frekuensi pembaruan
direktori setiap 30 min; posisi setiap 5 min; fill setiap 10 s; cache API 30 s
Jendela
30 hari agregat harian; koin teratas dari fill yang tersimpan
Sumber data
Profil vault: info direktori, posisi saat ini beserta jarak likuidasi, metrik gaya trading, dan agregat harian 30 hari yang disusun dari fill vault yang dibaca dari node milik kami.
Cakupan bursa
Semua vault di direktori resmi; posisi hanya untuk vault dengan TVL >= 10.000 USD
Paginasi
tidak ada
Satuan
USD; ratios as decimals
Metode
takerRatio = taker notional / total notional; dailyTurnover = volume / days / TVL; liqDistance = |mark - liqPx| / mark with mark = positionValue / |size|
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 2004 msSkema sesuaiTitik data terbaru berusia 0s

Vault induk (seperti HLP) memegang posisi di vault anak, sehingga `positions`, `topCoins`, dan `daily` bisa kosong untuk vault tersebut.

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/vault-profile/:addrSebagian
Parameter

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

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