> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chainstack.com/llms.txt
> Use this file to discover all available pages before exploring further.
# leadingVaults | Hyperliquid info
> The info endpoint with type: "leadingVaults" retrieves information about all vaults managed by a specific vault leader on the Hyperliquid exchange.
This method is available on Chainstack. Not all Hyperliquid methods are available on Chainstack, as the open-source node implementation does not support them yet — see [Hyperliquid methods](/docs/hyperliquid-methods) for the full availability breakdown.
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.
## 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 Shell theme={"system"}
curl -X POST \
-H "Content-Type: application/json" \
-d '{"type": "leadingVaults", "user": "0x31ca8395cf837de08b24da3f660e77761dfb974b"}' \
https://hyperliquid-mainnet.core.chainstack.com/4f8d8f4040bdacd1577bff8058438274/info
```
```python Python (hyperliquid-python-sdk) theme={"system"}
from hyperliquid.info import Info
# The hyperliquid-python-sdk Info class has no dedicated leadingVaults
# helper, so use its generic post method, which targets the same /info
# endpoint and {"type": "leadingVaults"} request body as the curl above.
info = Info("YOUR_CHAINSTACK_ENDPOINT", skip_ws=True)
leading_vaults = info.post(
"/info",
{
"type": "leadingVaults",
"user": "0x31ca8395cf837de08b24da3f660e77761dfb974b",
},
)
print(leading_vaults)
```
```typescript TypeScript (@nktkas/hyperliquid) theme={"system"}
import { HttpTransport, InfoClient } from "@nktkas/hyperliquid";
const transport = new HttpTransport({ apiUrl: "YOUR_CHAINSTACK_ENDPOINT" });
const info = new InfoClient({ transport });
const leadingVaults = await info.leadingVaults({
user: "0x31ca8395cf837de08b24da3f660e77761dfb974b",
});
console.log(leadingVaults);
```
**Use your own endpoint in your code.** The code examples use a placeholder Chainstack endpoint (YOUR\_CHAINSTACK\_ENDPOINT) — replace it with your own Hyperliquid node endpoint from the [Chainstack console](https://console.chainstack.com/). The curl above uses a shared public endpoint for quick checks only; do not use it in production.
## 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.
## OpenAPI
````yaml openapi/hyperliquid_node_api/hypercore_info/info_leadingvaults.json post /4f8d8f4040bdacd1577bff8058438274/info
openapi: 3.0.0
info:
title: Hyperliquid Node API
version: 1.0.0
description: This is an API for interacting with Chainstack Hyperliquid node.
servers:
- url: https://hyperliquid-mainnet.core.chainstack.com
security: []
paths:
/4f8d8f4040bdacd1577bff8058438274/info:
post:
tags:
- hyperliquid operations
summary: info (leadingVaults)
operationId: infoLeadingVaults
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
type:
type: string
default: leadingVaults
enum:
- leadingVaults
description: Request type to retrieve vaults led by a specific user
user:
type: string
default: '0x31ca8395cf837de08b24da3f660e77761dfb974b'
description: >-
Address in 42-character hexadecimal format of the vault
leader
required:
- type
- user
responses:
'200':
description: Information about vaults led by the specified user
content:
application/json:
schema:
type: array
description: List of vaults managed by the specified vault leader
items:
type: object
properties:
vaultAddress:
type: string
description: Contract address of the vault
name:
type: string
description: Human-readable name of the vault
leader:
type: string
description: >-
Address of the vault leader (should match the requested
user)
totalShares:
type: string
description: Total number of shares issued by the vault
tvl:
type: string
description: Total value locked in the vault (USD)
sharePrice:
type: string
description: Current price per share
pnl1D:
type: string
description: 1-day profit and loss percentage
pnl7D:
type: string
description: 7-day profit and loss percentage
pnl30D:
type: string
description: 30-day profit and loss percentage
pnlAllTime:
type: string
description: All-time profit and loss percentage
maxDD:
type: string
description: Maximum drawdown percentage
isOpen:
type: boolean
description: Whether the vault is open for new deposits
minDeposit:
type: string
description: Minimum deposit amount required
createdTime:
type: integer
description: Vault creation timestamp in milliseconds
leaderCommission:
type: string
description: Commission percentage taken by the vault leader
required:
- vaultAddress
- name
- leader
````