Skip to main content
POST
vaultDetails | Hyperliquid Info API

Credit Cost

1 per call

Processing

Realtime
The Hyperliquid info endpoint with type: "vaultDetails" is used to fetch detailed information for a specific vault.
Estimate your monthly cost for this API using the Pricing Calculator.
  • Wire-equal to POST api.hyperliquid.xyz/info with {"type": "vaultDetails", "vaultAddress": "..."}.
  • vaultAddress is required; the optional user field populates followerState with that wallet’s position in the vault.
  • portfolio is an array of [period, series] pairs bucketed by day, week, month, allTime, and their perp* 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.
Returns the full detail for a single vault: identity (name, address, leader, description), time-bucketed performance history (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.
Last reviewed: 2026-07-24