/api/hl/vaults/overview
GETTersedia

Tabel ikhtisar vault Hyperliquid

Tabel ikhtisar vault Hyperliquid (TVL, APR, eksposur)

GET/api/hl/vaults/overview

Permintaan

Parameter kueri

NamaTipeWajibDefaultNilai yang diizinkanDeskripsi
sortstringOpsionaltvltvl, apr, exposure, long, short, upnl, vol24h, pnl24hKunci pengurutan.
dirstringOpsionaldescasc, descArah pengurutan.
limitintegerOpsional100≤ 300Jumlah baris yang dikembalikan. Contoh: 100
qstringOpsional——Cari berdasarkan nama / alamat (maks 60 karakter).

Contoh permintaan

curl -s "https://www.coinboss.com/api/hl/vaults/overview?limit=100"

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.
totalsobject—Total.
totals.vaultsnumbercountJumlah vault terbuka dengan TVL di atas 0 (sebelum `limit` dan pencarian diterapkan).
totals.tvlUsdnumberUSDJumlah TVL atas vault-vault tersebut.
totals.pollednumbercountVault yang posisinya sudah dibaca setidaknya sekali; hanya vault ini yang berkontribusi pada total long / short.
totals.longUsdnumberUSDNosional long.
totals.shortUsdnumberUSDNosional short.
totals.syncedAtnumbermsStempel waktu.
rowsarray—Baris hasil.
rows[]object—Baris hasil.
rows[].addressstring—Alamat on-chain.
rows[].namestring—Nama.
rows[].leaderstring—Alamat leader vault.
rows[].tvlnumberUSDTotal nilai terkunci di vault.
rows[].aprnumber—Imbal hasil vault yang disetahunkan.
rows[].relTypestring—Jenis hubungan dari direktori vault Hyperliquid: `parent`, `child`, atau `normal`.
rows[].parentAddressstring|null—Alamat vault induk jika ini adalah vault anak; selain itu null.
rows[].createTimenumbermsStempel waktu.
rows[].accountValuenumberUSDEkuitas akun.
rows[].positionValuenumberUSDNosional posisi.
rows[].longValuenumberUSDNosional long.
rows[].shortValuenumberUSDNosional short.
rows[].totalUpnlnumberUSDTotal PnL yang belum direalisasi.
rows[].posCountnumbercountJumlah posisi terbuka pada polling posisi terakhir; null jika vault belum pernah di-polling.
rows[].posPolledAtnumbermsWaktu posisi terakhir di-polling.
rows[].vol24hnumber|nullUSDVolume nosional fill vault pada hari UTC berjalan dan sebelumnya (24 hingga 48 jam, bukan 24h bergulir); null jika tidak ada fill yang tercatat.
rows[].pnl24hnumber|nullUSDClosed PnL fill vault pada hari UTC berjalan dan sebelumnya; null jika tidak ada fill yang tercatat.
rows[].fills24hnumber|nullcountJumlah fill vault pada hari UTC berjalan dan sebelumnya; null jika tidak ada yang tercatat.

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

Contoh respons

/api/hl/vaults/overview?limit=100 · Respons nyata yang direkam 2026-11-13 03:58:41 UTC. Array dan map yang panjang dipersingkat untuk tampilan: rows berisi 100 item.

  • {
    • "success": true,
    • "updated": 1794542321291,
    • "totals": {
      • "vaults": 2907,
      • "tvlUsd": 367445957.14,
      • "polled": 299,
      • "longUsd": 115759575.06,
      • "shortUsd": 31020454.97,
      • "syncedAt": 1794542172182
      },
    • "rows": [
      • { … 18 },
      • { … 18 }
      ]
    }

Detail

Autentikasi
Tidak ada. Endpoint publik.
Batas permintaan
1200 permintaan per menit per IP
Cache server
60s
Mikro-cache edge
10s
Frekuensi pembaruan
direktori setiap 30 min; posisi vault dengan TVL >= 10.000 USD setiap 5 min; fill setiap 10 s; cache API 60 s
Jendela
snapshot terbaru; vol24h / pnl24h mencakup hari UTC berjalan dan sebelumnya
Sumber data
Daftar vault Hyperliquid dengan TVL/APR dari direktori vault resmi, eksposur saat ini yang di-polling dari API info resmi, dan volume/PnL 24h dari fill vault yang dibaca dari node milik kami.
Cakupan bursa
Vault terbuka dengan TVL > 0 (sekitar 2.900); eksposur hanya untuk ~300 vault yang di-polling
Paginasi
limit (default 100, maks 300); pencarian q
Pengurutan
sort = tvl (default) | apr | exposure | long | short | upnl | vol24h | pnl24h; dir = desc | asc
Satuan
USD; APR as reported upstream
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 20014 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/vaults/overviewTersedia
Parameter

string · default tvl — Sort key.

string · default desc — Sort direction.

integer · default 100 · maks 300 — Number of rows to return.

string — Search by name / address (max 60 chars).

URL permintaanhttps://www.coinboss.com/api/hl/vaults/overview?limit=100
Pilih endpoint lalu tekan “Kirim permintaan”. Respons, header, dan waktu tempuhnya akan muncul di sini.