vaultDetails | Hyperliquid Info API
Info API
vaultDetails | Hyperliquid Info API
Hyperliquid vaultDetails: fetch detailed information for a specific vault.
POST
vaultDetails | Hyperliquid Info API
Credit Cost
1 per call
Processing
Realtime
type: "vaultDetails" is used to fetch detailed information for a specific vault.
- Wire-equal to
POST api.hyperliquid.xyz/infowith{"type": "vaultDetails", "vaultAddress": "..."}. vaultAddressis required; the optionaluserfield populatesfollowerStatewith that wallet’s position in the vault.portfoliois an array of[period, series]pairs bucketed byday,week,month,allTime, and theirperp*variants.- Aggregate stats (
apr,leaderFraction,leaderCommission,maxDistributable,maxWithdrawable) are JSON numbers, while position, equity, and history values are decimal strings. - For a lightweight list across all vaults, use vaultSummaries.
portfolio), headline stats (apr, distributable and withdrawable amounts), the follower roster, and the vault’s relationship to any parent or child vaults.
Pass the optional user field to have followerState reflect that wallet’s position in the vault.
Endpoint
Request
string
default:"vaultDetails"
required
Always
"vaultDetails".string
required
The vault contract address (lowercase 0x-prefixed hex).
string
Optional wallet address (lowercase 0x-prefixed hex). When supplied,
followerState is populated with that wallet’s position in the vault.Example
Response
A single object describing the vault.Field descriptions
Position, equity, and history values (
portfolio account-value/PnL samples, vlm, and follower vaultEquity/pnl/allTimePnl) are returned as decimal strings. The aggregate stats apr, leaderFraction, leaderCommission, maxDistributable, and maxWithdrawable are returned as JSON numbers.string
Vault name.
string
Vault contract address (0x-prefixed hex).
string
Vault leader (manager) address.
string
Free-text description of the vault’s strategy.
array<[string, object]>
Time-bucketed performance history. Each element is a
[period, series] pair, where period is one of day, week, month, allTime, perpDay, perpWeek, perpMonth, or perpAllTime, and series holds the account-value and PnL time series for that period.number
Annualized return as a raw fraction (e.g.
0.3639 = 36.39%).object | null
The requesting
user’s follower state in this vault when the optional user field is supplied; null otherwise.number
Fraction of the vault’s equity held by the leader.
number
Leader’s commission rate (fraction of follower profits).
array<object>
Per-follower positions in the vault.
number
Maximum amount currently distributable from the vault, in USD.
number
Maximum amount the leader can currently withdraw, in USD.
boolean
Whether the vault is closed.
object
Relationship metadata for the vault.
boolean
Whether the vault currently accepts new deposits.
boolean
Whether a withdrawal always fully closes the follower’s position.