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

Response

200 - application/json

Information about vaults led by the specified user

List of vaults managed by the specified vault leader