createVault (gRPC) | Hyperliquid API Docs

Create a new trading vault on Hyperliquid. Enable vault-based trading strategies with depositor management.

Create a new trading vault on Hyperliquid. Vaults allow users to create managed trading strategies where other users can deposit funds and share in the trading results.

Sample Data

JSON

{
  "signature": {
    "r": "0x888843b89133ec3eaf8d81601a680a56fe026232233760e741e886269d6d47e4",
    "s": "0x26b3a835ef519f69ad117a4050658157bf9d4a6c253985b91f20c074c648ea62",
    "v": 28
  },
  "action": {
    "type": "createVault",
    "name": "TradingFXVPS",
    "description": "Traders seeking alpha beyond buy-and-hold crypto...",
    "initialUsd": 4999000000,
    "nonce": 1768149497821
  },
  "nonce": 1768149497821,
  "expiresAfter": 1768149511760
}

View this transaction on Hypurrscan

Field Reference

Action Fields

Field	Type	Description
`type`	string	Always `"createVault"`
`name`	string	Display name for the vault
`description`	string	Vault description (supports markdown/text)
`initialUsd`	number	Initial USD deposit in atomic units (divide by 10^6 for USD)
`nonce`	number	Transaction nonce for replay protection

Optional Fields

Field	Type	Description
`expiresAfter`	number	Timestamp after which the action expires

Amount Conversion

The initialUsd field is in atomic units:

4999000000 atomic units = $4,999.00 USD (divide by 10^6)

Use Cases

Vault Analytics

Track vault creation activity:

Python

def process_createVault_action(action):
    name = action.get('name')
    initial_usd = action.get('initialUsd', 0)
    initial_usd_display = initial_usd / 1_000_000

    print(f"New vault created: {name}")
    print(f"Initial deposit: ${initial_usd_display:,.2f}")

Strategy Monitoring

Identify new trading strategies being launched on the platform.

Ecosystem Growth Analysis

Track vault creation trends to measure platform adoption.

vaultTransfer - Deposit or withdraw from vault
NetChildVaultPositionsAction - Net child vault positions

createVault - Create Trading Vault