๐Ÿ”Œ API & Developers

Hyperliquid userVaultEquities Info API: Query a User's Vault Deposits

โš ๏ธ Disclosure: Some links on this page are affiliate links. If you sign up through them, I may earn a commission โ€” at no extra cost to you.
The userVaultEquities request type returns a user's vault deposit equities from Hyperliquid's Info endpoint. Send a POST request to https://api.hyperliquid.xyz/info with Content-Type: application/json.

Request fields

FieldRequiredTypeValue / description
typeYesStringuserVaultEquities
userYesStringAddress in 42-character hexadecimal format, e.g. 0x0000000000000000000000000000000000000000
The Info endpoint documentation notes that when querying account data associated with a master or sub-account, you must pass the actual address of that account. Using an agent wallet's address is listed as a common pitfall that leads to an empty result.

Example request body:

{
  "type": "userVaultEquities",
  "user": "0x0000000000000000000000000000000000000000"
}

Response shape

A successful response is a JSON array. Each element documents these fields:

FieldTypeMeaning
vaultAddressStringVault address associated with the returned equity
equityStringThe user's equity in that vault
Example response from the documentation:

[
  {
    "vaultAddress": "0xdfc24b077bc1425ad1dea75bcb6f8158e10df303",
    "equity": "742500.082809"
  }
]

๐Ÿ’ก Hyperliquid

Like what you're reading? Try it yourself โ€” this link supports ChartedTrader at no cost to you.

Create or access Hyperliquid โ†’
๐ŸŽ You receive: 4% fee discount on first $25M volume ยท per account, lifetime

This endpoint returns per-vault equity entries for the queried user. It is separate from the vaultDetails request, which returns vault-level metadata such as name, leader, description, portfolio history, followers, APR, parent/child relationships, and fields like maxWithdrawable, maxDistributable, allowDeposits, alwaysCloseOnWithdraw, and isClosed.

Example call

The following curl command is a reference request constructed from the documented fields, not a logged test run:

curl -X POST https://api.hyperliquid.xyz/info \
  -H 'Content-Type: application/json' \
  -d '{"type":"userVaultEquities","user":"0x0000000000000000000000000000000000000000"}'

For making vault deposits or withdrawals, see Hyperliquid vaultTransfer API. For lockup and withdrawal timing, see Hyperliquid Vault Lockup & Withdrawal Schedule.

Source

Hyperliquid access

Create or access Hyperliquid โ€” this affiliate link may earn a referral reward.

Continue with Hyperliquid

Browse the Hyperliquid guide hub for the complete user journey.

๐Ÿงฎ Free Hyperliquid calculators

Fee Calculator โ†’
Hyperliquid vs centralized exchange fee comparison
PnL & Liquidation โ†’
Perp PnL + liquidation price
Position Size โ†’
Risk-aware position sizing for HL perps
Hyperliquid

Ready to get started? Use the link below โ€” it helps support ChartedTrader at no cost to you.

Create or access Hyperliquid โ†’
๐ŸŽ You receive: 4% fee discount on first $25M volume ยท per account, lifetime
๐Ÿ“ˆ

About the author

I'm a systematic trader running live strategies on IB (USDJPY momentum) and Hyperliquid (crypto perps). Questions? Reach out.

๐Ÿ“š Related Articles

๐Ÿ”Œ
API & Developers

Hyperliquid userRole Info Endpoint: Request, Response Objects, and Python Example

Use the Hyperliquid info endpoint's userRole type to identify whether an address is a user, agent, vault, sub-account, or missing, and inspect the returned data fields.

November 12, 2026 โฑ 2 min read
๐Ÿ”Œ
API & Developers

Hyperliquid orderStatus Info Request: oid, cloid, and Response Shapes

How to query one Hyperliquid order by numeric oid or client order ID using the info endpoint, with request fields, examples, and response shapes.

November 18, 2026 โฑ 4 min read
๐Ÿ”Œ
API & Developers

Hyperliquid API: Query Borrow/Lend User and Reserve State (2026)

Query Hyperliquid's borrowLendUserState, borrowLendReserveState, and allBorrowLendReserveStates info requests, response fields, and health outputs.

November 13, 2026 โฑ 4 min read