Skip to main content
POST
userVaultEquities | Hyperliquid Info API

Credit Cost

1 per call

Processing

Realtime
The Hyperliquid info endpoint with type: "userVaultEquities" is used to fetch a user’s locked vault equity positions across all vaults they have deposited into.
Estimate your monthly cost for this API using the Pricing Calculator.
  • Wire-equal to POST api.hyperliquid.xyz/info with {"type": "userVaultEquities", "user": "..."}.
  • For real-time push of vault deposit, withdrawal, and distribution events, subscribe to walletTxs and read LedgerVaultDepositLedgerVaultWithdraw, and LedgerVaultDistribution entries.
Returns the wallet’s per-vault equity: one entry per vault the user has deposited into, with the locked amount and the timestamp at which that equity becomes unlockable. User-keyed. The result is [] for wallets that haven’t deposited into any vault.

Endpoint

Request

type
string
default:"userVaultEquities"
required
Always "userVaultEquities".
user
string
required
The wallet address (lowercase 0x-prefixed hex).

Example

Response

An array of vault equity entries.

Field descriptions

equity is returned as a decimal string, preserving upstream precision. Do not parse it as a float - keep it as a string or use a fixed-precision decimal type.
vaultAddress
string
Vault contract address (0x-prefixed hex).
equity
string
User’s equity in this vault, in USD.
lockedUntilTimestamp
int
Unix timestamp in milliseconds at which this equity becomes unlockable.

userFills

fetch a user’s most recent trade fills without specifying a time window.

userFillsByTime

fetch a user’s trade fills within a time window for P&L recaps and tax ledger reconstruction.

userFunding

fetch a user’s per-coin funding payment history within a time window for funding-only P&L attribution.

userNonFundingLedgerUpdates

fetch a user’s non-funding USDC ledger history (deposits, withdrawals, transfers, vault flows) within a time…
Last reviewed: 2026-06-13