/api/hl/vault/:addr
GETTersedia

Detail vault Hyperliquid

Detail vault Hyperliquid

GET/api/hl/vault/:addr

Permintaan

Parameter kueri

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

Parameter bertanda “path” merupakan bagian dari URL.

Contoh permintaan

curl -s "https://www.coinboss.com/api/hl/vault/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.
namestring—Nama.
vaultAddressstring—Alamat vault.
leaderstring—Alamat leader vault.
descriptionstring—Teks deskripsi yang ditulis pemimpin vault, sebagaimana dipublikasikan Hyperliquid; string kosong jika tidak ada.
aprnumber—Imbal hasil vault yang disetahunkan.
maxDistributablenumberUSDJumlah maksimum yang saat ini dapat dibayarkan vault kepada deposan, sebagaimana dilaporkan Hyperliquid.
isClosedboolean—True jika vault ditutup.
allowDepositsboolean—False hanya jika Hyperliquid melaporkan bahwa vault tidak menerima deposit.
followerCountnumbercountJumlah catatan deposan yang dikembalikan Hyperliquid untuk vault ini (daftarnya dibatasi, sehingga vault besar menampilkan angka batas tersebut); null jika tidak dikembalikan.
portfolioobject—Riwayat nilai akun dan PnL vault per jendela waktu. kunci dinamis: day,week,month,allTime,perpDay,perpWeek
portfolio.{*}object—Kuncinya adalah jendela `day`, `week`, `month`, `allTime` serta versi khusus perpetual `perpDay`, `perpWeek`, `perpMonth`, `perpAllTime`.
portfolio.{*}.accountValueHistoryarray—Nilai akun vault selama jendela, dari yang terlama.
portfolio.{*}.accountValueHistory[]array—Satu titik: `[timestamp, account value]`.
portfolio.{*}.accountValueHistory[][]number—Elemen pertama adalah stempel waktu dalam ms, elemen kedua adalah nilai akun dalam USD.
portfolio.{*}.pnlHistoryarray—PnL kumulatif vault sejak awal jendela, dari yang terlama.
portfolio.{*}.pnlHistory[]array—Satu titik: `[timestamp, cumulative PnL]`.
portfolio.{*}.pnlHistory[][]number—Elemen pertama adalah stempel waktu dalam ms, elemen kedua adalah PnL kumulatif dalam USD.
portfolio.{*}.vlmnumberUSDVolume perdagangan vault dalam jendela, sebagaimana dilaporkan Hyperliquid.

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

Contoh respons

/api/hl/vault/0xdfc24b077bc1425ad1dea75bcb6f8158e10df303 · Respons nyata yang direkam 2026-11-13 03:58:38 UTC. Array dan map yang panjang dipersingkat untuk tampilan: portfolio berisi 8 item; portfolio.{*}.pnlHistory berisi 63 item; portfolio.{*}.accountValueHistory berisi 63 item.

  • {
    • "success": true,
    • "updated": 1794542319008,
    • "name": "Hyperliquidity Provider (HLP)",
    • "vaultAddress": "0xdfc24b077bc1425ad1dea75bcb6f8158e10df303",
    • "leader": "0x677d831aef5328190852e24f13c46cac05f984e7",
    • "description": "This community-owned vault provides liquidity to Hyperliquid through multiple market making strategies, performs liquidations, and accrues platform fees.",
    • "apr": 0.22667592086684252,
    • "maxDistributable": 10172508.94846,
    • "isClosed": false,
    • "allowDeposits": true,
    • "followerCount": 100,
    • "portfolio": {
      • "day": { … 3 },
      • "week": { … 3 }
      }
    }

Detail

Autentikasi
Tidak ada. Endpoint publik.
Batas permintaan
1200 permintaan per menit per IP
Cache server
60s
Mikro-cache edge
10s
Frekuensi pembaruan
diambil saat diminta; cache API 60 s
Jendela
deret portofolio day / week / month / allTime sebagaimana disediakan sumber hulu
Sumber data
Detail vault dan kurva ekuitas/PnL yang diteruskan dari API info resmi Hyperliquid.
Cakupan bursa
Alamat vault Hyperliquid mana pun
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:38 UTCHTTP 200118 msSkema sesuaiTitik data terbaru berusia 0s

Ketersediaan, 30 hari terakhir

100% 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/vault/:addrTersedia
Parameter

string — 0x-prefixed 40-hex address; 400 on bad format; 404 if vault unknown.

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