userVaultEquities - HyperCore Info Endpoint
Get one Hyperliquid address's vault deposits with userVaultEquities. Each entry has the vault address, the address's equity and the time its lock ends.
Hyperliquid RPC endpoint: endpoint URLs, plans and pricing.
Get one address's deposits across Hyperliquid vaults. Each entry has vaultAddress and equity, and in our tests also lockedUntilTimestamp.
Authenticate by including your Dwellir API key in the URL path: https://api-hyperliquid-mainnet-info.n.dwellir.com/YOUR_API_KEY/info.
When to use this method
Use userVaultEquities to show which vaults hold an address's funds, the equity in each vault and when each lock ends.
The response has no vault name, share count, deposit total or profit and loss (PnL) field. Equity alone cannot produce net deposits or PnL, so get those from another source.
This method reads a depositor's stake, not the trades inside a vault. To read a vault's own positions, pass its address to batchClearinghouseStates. The Hyperliquid vault data guide does this for every open vault.
curl -X POST "https://api-hyperliquid-mainnet-info.n.dwellir.com/YOUR_API_KEY/info" \
-H "content-type: application/json" \
-d '{
"type": "userVaultEquities",
"user": "0x66e7293b07744b2d92384d33a0f86b9c333d8597"
}'Label deposits and split locked equity
This script takes vault names from Hyperliquid's stats file, because userVaultEquities does not return them. It sums equity with Decimal to keep the returned precision. The stats file is about 14 MB, so cache it in a long-running service.
import os
import time
from decimal import Decimal
import requests
INFO_URL = (
"https://api-hyperliquid-mainnet-info.n.dwellir.com/"
f"{os.environ['DWELLIR_API_KEY']}/info"
)
STATS_URL = "https://stats-data.hyperliquid.xyz/Mainnet/vaults"
USER = "0x66e7293b07744b2d92384d33a0f86b9c333d8597"
response = requests.post(
INFO_URL, json={"type": "userVaultEquities", "user": USER}, timeout=30
)
response.raise_for_status()
deposits = response.json()
response = requests.get(STATS_URL, timeout=60)
response.raise_for_status()
names = {
entry["summary"]["vaultAddress"].lower(): entry["summary"]["name"]
for entry in response.json()
}
now_ms = time.time() * 1000
totals = {"locked": Decimal(0), "not locked": Decimal(0), "lock UNKNOWN": Decimal(0)}
for deposit in deposits:
equity = Decimal(deposit["equity"])
lock_end = deposit.get("lockedUntilTimestamp")
if lock_end is None:
status = "lock UNKNOWN"
else:
status = "locked" if lock_end > now_ms else "not locked"
totals[status] += equity
name = names.get(deposit["vaultAddress"].lower(), "UNKNOWN")
print(f"{name}: {equity} ({status})")
for status, total in totals.items():
print(f"{status}: {total}")We ran it on 6 November 2026 at 04:20 Stockholm time:
Orbit Value Strategies: 10346.112815 (not locked)
locked: 0
not locked: 10346.112815
lock UNKNOWN: 0Handle the response
- Empty list: An address with no listed deposit returned
[]with HTTP 200 on 6 November 2026. Show this as no deposits, not as an error. - Missing
user: The request returned HTTP 422 withFailed to deserialize the JSON body into the target type. - Changing equity: Read
equityas a value at request time. For one address, the Dwellir endpoint returned10338.904518and the public endpoint returned10337.2984927 seconds later. - Lock field: Hyperliquid's Info reference shows only
vaultAddressandequity. Both endpoints also returnedlockedUntilTimestampon 6 November 2026, so the samples on this page handle a response without it.
Related endpoints
- leadingVaults: Get the open vaults one address leads
- vaultSummaries: Check the method's measured response and find the full vault list
- clearinghouseState: Get user's perpetual account state
- spotClearinghouseState: Get spot trading balances
Read Hyperliquid vault deposits with Dwellir's HyperCore Info Endpoint. Get your API key →