Skip to main content
POST
/
4f8d8f4040bdacd1577bff8058438274
/
info
info (vaultSummaries)
curl --request POST \
  --url https://hyperliquid-mainnet.core.chainstack.com/4f8d8f4040bdacd1577bff8058438274/info \
  --header 'Content-Type: application/json' \
  --data '{
  "type": "vaultSummaries"
}'
[
  {
    "name": "<string>",
    "vaultAddress": "<string>",
    "leader": "<string>",
    "tvl": "<string>",
    "isClosed": true,
    "relationship": {
      "type": "normal",
      "data": {
        "childAddresses": [
          "<string>"
        ]
      }
    },
    "createTimeMillis": 123
  }
]
The info endpoint with type: "vaultSummaries" retrieves summary information for all available vaults on the Hyperliquid exchange. This endpoint provides vault metadata including names, addresses, TVL, and relationship information for all vaults in the system.
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.
Data availabilityThis endpoint returns all available vaults in the system. If the response is an empty array, it indicates that no vaults are currently deployed on the network.For detailed information about a specific vault, use the vaultDetails endpoint.

​
Parameters

​
Request body

  • type (string, required) — The request type. Must be "vaultSummaries" to retrieve vault summaries.

​
Response

The response is an array of vault summary objects containing the following fields:

​
Vault identification

  • name (string) — Name of the vault
  • vaultAddress (string) — Vault’s blockchain address (42-character hexadecimal)
  • leader (string) — Address of the vault leader/manager

​
Vault metrics

  • tvl (string) — Total Value Locked in the vault
  • isClosed (boolean) — Whether the vault is closed to new deposits
  • createTimeMillis (number) — Timestamp when vault was created (in milliseconds since Unix epoch)

​
Relationship information

  • relationship (object) — Vault relationship structure
    • type (string) — Type of vault relationship: "normal", "child", or "parent"
    • data (object, optional) — Additional relationship data
      • childAddresses (array of strings) — If parent vault, contains addresses of child vaults

​
Understanding vault relationships

Vault types:
  • Normal vaults: Standard standalone vaults
  • Parent vaults: Vaults that manage or control other child vaults
  • Child vaults: Vaults that are controlled by a parent vault
Vault status:
  • Open vaults: isClosed: false - accepting new deposits
  • Closed vaults: isClosed: true - not accepting new deposits

​
Example request

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

​
Example response

[
  {
    "name": "Alpha Strategy Vault",
    "vaultAddress": "0xdfc24b077bc1425ad1dea75bcb6f8158e10df303",
    "leader": "0x677d831aef5328190852e24f13c46cac05f984e7",
    "tvl": "1500000.50",
    "isClosed": false,
    "relationship": {
      "type": "normal"
    },
    "createTimeMillis": 1704067200000
  },
  {
    "name": "Beta Fund",
    "vaultAddress": "0x789abc123def456ghi789jkl012mno345pqr678",
    "leader": "0x012def456ghi789jkl012mno345pqr678stu901",
    "tvl": "5000000.25",
    "isClosed": false,
    "relationship": {
      "type": "parent",
      "data": {
        "childAddresses": [
          "0xaaa111bbb222ccc333ddd444eee555fff666777",
          "0x888999aaabbbcccdddeeefff000111222333444"
        ]
      }
    },
    "createTimeMillis": 1704153600000
  }
]

​
Use case

The info endpoint with type: "vaultSummaries" is essential for applications that need to:
  • Vault discovery: Browse all available vaults in the system
  • TVL analysis: Monitor total value locked across different vaults
  • Vault status: Check which vaults are open or closed for deposits
  • Relationship mapping: Understand parent-child vault relationships
  • Vault listing: Build interfaces showing all available vaults
  • Leader tracking: Identify vault managers and their addresses
  • Historical analysis: Track when vaults were created
  • Vault hierarchies: Map complex vault structures with parent-child relationships
  • System overview: Get a complete picture of all vaults in the ecosystem
  • Integration points: Feed vault data into portfolio management systems
  • Monitoring systems: Track new vault deployments and closures
  • Data aggregation: Collect comprehensive vault metadata for analysis
This endpoint provides the foundational data needed to understand the complete vault ecosystem on Hyperliquid, serving as the primary discovery mechanism for all available vaults.

Body

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

Request type to retrieve vault summaries for all available vaults

Available options:
vaultSummaries

Response

200 - application/json

Summary information for all available vaults

List of vault summaries

​
name
string
required

Name of the vault

​
vaultAddress
string
required

Vault's blockchain address

​
leader
string
required

Address of the vault leader/manager

​
tvl
string
required

Total Value Locked in the vault

​
isClosed
boolean
required

Whether the vault is closed to new deposits

​
relationship
object
required

Vault relationship information

​
createTimeMillis
number
required

Timestamp when vault was created (in milliseconds)