POST
/
4f8d8f4040bdacd1577bff8058438274
/
info
info (leadingVaults)
curl --request POST \
  --url https://hyperliquid-mainnet.core.chainstack.com/4f8d8f4040bdacd1577bff8058438274/info \
  --header 'Content-Type: application/json' \
  --data '{
  "type": "leadingVaults",
  "user": "0x31ca8395cf837de08b24da3f660e77761dfb974b"
}'
[
  {
    "vaultAddress": "<string>",
    "name": "<string>",
    "leader": "<string>",
    "totalShares": "<string>",
    "tvl": "<string>",
    "sharePrice": "<string>",
    "pnl1D": "<string>",
    "pnl7D": "<string>",
    "pnl30D": "<string>",
    "pnlAllTime": "<string>",
    "maxDD": "<string>",
    "isOpen": true,
    "minDeposit": "<string>",
    "createdTime": 123,
    "leaderCommission": "<string>"
  }
]
The info endpoint with type: "leadingVaults" retrieves information about all vaults managed by a specific vault leader on the Hyperliquid exchange. This endpoint provides comprehensive data about a vault leader’s managed funds, including performance metrics, vault configurations, and management details.
Get your own node endpoint todayStart for free and get your app to production levels immediately. No credit card required.You can sign up with your GitHub, X, Google, or Microsoft account.

​
Parameters

​
Request body

  • type (string, required) — The request type. Must be "leadingVaults" to retrieve vaults led by a specific user.
  • user (string, required) — Address in 42-character hexadecimal format of the vault leader (e.g., 0x31ca8395cf837de08b24da3f660e77761dfb974b).

​
Response

The response is an array of vault objects managed by the specified vault leader:

​
Vault identification

  • vaultAddress (string) — Contract address of the vault (42-character hexadecimal)
  • name (string) — Human-readable name of the vault
  • leader (string) — Address of the vault leader (matches the requested user)

​
Vault metrics

  • totalShares (string) — Total number of shares issued by the vault
  • tvl (string) — Total value locked in the vault expressed in USD
  • sharePrice (string) — Current price per share reflecting cumulative performance

​
Performance metrics

  • pnl1D (string) — 1-day profit and loss percentage
  • pnl7D (string) — 7-day profit and loss percentage
  • pnl30D (string) — 30-day profit and loss percentage
  • pnlAllTime (string) — All-time profit and loss percentage since vault inception
  • maxDD (string) — Maximum drawdown percentage (worst peak-to-trough decline)

​
Vault configuration

  • isOpen (boolean) — Whether the vault is currently accepting new deposits
  • minDeposit (string) — Minimum deposit amount required to invest in the vault
  • createdTime (integer) — Vault creation timestamp in milliseconds
  • leaderCommission (string) — Commission percentage taken by the vault leader

​
Understanding vault leadership

Vault leader responsibilities:
  • Trading decisions: Making all buy/sell decisions for the vault
  • Risk management: Managing leverage and position sizing
  • Strategy execution: Implementing trading strategies
  • Performance accountability: Responsible for vault returns
Commission structure:
  • Leaders typically earn a percentage of profits as commission
  • Commission rates vary by vault and leader agreement
  • Incentivizes leaders to maximize vault performance
Vault lifecycle:
  • Creation: Leaders can create new vaults with specific parameters
  • Management: Ongoing trading and strategy execution
  • Performance tracking: Historical record of all trading decisions

​
Example request

Shell
curl -X POST \
  -H "Content-Type: application/json" \
  -d '{"type": "leadingVaults", "user": "0x31ca8395cf837de08b24da3f660e77761dfb974b"}' \
  https://hyperliquid-mainnet.core.chainstack.com/4f8d8f4040bdacd1577bff8058438274/info

​
Use case

The info endpoint with type: "leadingVaults" is essential for applications that need to:
  • Vault leader analysis: Evaluate the track record and performance of specific vault leaders
  • Due diligence: Research vault leaders before making investment decisions
  • Performance tracking: Monitor the performance of vaults managed by specific leaders
  • Leader dashboards: Build management interfaces for vault leaders to track their funds
  • Portfolio analysis: Analyze the investment style and strategy of vault leaders
  • Leader comparison: Compare performance across different vault leaders
  • Risk assessment: Evaluate the risk profile of vaults managed by specific leaders
  • Investment research: Identify top-performing vault leaders for potential investments
  • Vault management tools: Build tools for vault leaders to manage their funds
  • Performance analytics: Analyze leader performance across different market conditions
  • Leader reputation systems: Build reputation scoring based on vault performance
  • Investment platforms: Display leader-specific vault information to investors
  • Commission analysis: Understand the fee structure of different vault leaders
  • Strategy research: Study successful trading strategies employed by top leaders
This endpoint is particularly valuable for both investors who want to research vault leaders before investing and for vault leaders themselves who need to monitor and manage their vault portfolio. It provides comprehensive visibility into a leader’s vault management track record and current performance.

Body

application/json
​
type
enum<string>
default:leadingVaults
required

Request type to retrieve vaults led by a specific user

Available options:
leadingVaults
​
user
string
default:0x31ca8395cf837de08b24da3f660e77761dfb974b
required

Address in 42-character hexadecimal format of the vault leader

Response

200 - application/json

Information about vaults led by the specified user

List of vaults managed by the specified vault leader

​
vaultAddress
string
required

Contract address of the vault

​
name
string
required

Human-readable name of the vault

​
leader
string
required

Address of the vault leader (should match the requested user)

​
totalShares
string

Total number of shares issued by the vault

​
tvl
string

Total value locked in the vault (USD)

​
sharePrice
string

Current price per share

​
pnl1D
string

1-day profit and loss percentage

​
pnl7D
string

7-day profit and loss percentage

​
pnl30D
string

30-day profit and loss percentage

​
pnlAllTime
string

All-time profit and loss percentage

​
maxDD
string

Maximum drawdown percentage

​
isOpen
boolean

Whether the vault is open for new deposits

​
minDeposit
string

Minimum deposit amount required

​
createdTime
integer

Vault creation timestamp in milliseconds

​
leaderCommission
string

Commission percentage taken by the vault leader