Hyperliquid Vaults

Enter or exit Hyperliquid vaults, and deposit or withdraw funds.

Interact with Hyperliquid vaults: enter to follow a vault leader's strategy, or exit to reclaim your funds.

Uses the two-step POST /v1.2/safes/operations → PUT /v1.2/safes/operations flow.

1. Discover available Hyperliquid vaults

Retrieve active Hyperliquid vaults:

GET /v1.2/safes/vaults?provider=HYPERLIQUID
Header: X-Blockchain-Id: 42161

Each vault object contains poolAddress, name, apy, tvl, isDefault, and metadata with leader (vault leader address), isClosed, and relationship.

2. Enter a vault

Deposit funds into a Hyperliquid vault to follow a leader's trading strategy:

{
  "type": "HYPERLIQUID_ENTER_VAULT",
  "hyperliquidData": {
    "action": "ENTER_VAULT",
    "amount": 1000
  }
}

Field	Type	Required	Description
`type`	string	Yes	Must be `"HYPERLIQUID_ENTER_VAULT"`
`hyperliquidData.action`	string	Yes	Must be `"ENTER_VAULT"`
`hyperliquidData.amount`	number	Yes	Amount in USD to deposit

After the Safe operation executes on-chain, the server calls the Hyperliquid API server-side to enter the vault.

3. Exit a vault

Withdraw from a Hyperliquid vault:

{
  "type": "HYPERLIQUID_WITHDRAW_VAULT",
  "hyperliquidData": {
    "action": "WITHDRAW_VAULT",
    "amount": 500
  }
}

Field	Type	Required	Description
`type`	string	Yes	Must be `"HYPERLIQUID_WITHDRAW_VAULT"`
`hyperliquidData.action`	string	Yes	Must be `"WITHDRAW_VAULT"`
`hyperliquidData.amount`	number	Yes	Amount in USD to withdraw

4. Deposit / Withdraw USDC

Transfer USDC to or from your Hyperliquid account:

{
  "type": "HYPERLIQUID_DEPOSIT",
  "hyperliquidData": { "action": "DEPOSIT", "amount": 1000 }
}

{
  "type": "HYPERLIQUID_WITHDRAW",
  "hyperliquidData": { "action": "WITHDRAW", "amount": 500 }
}

5. Check positions

After entering a vault, check your Hyperliquid positions:

GET /v1.2/users/me/pools
Header: X-Blockchain-Id: 42161

The response pools array contains a HYPERLIQUID provider entry. Each item includes:

Field	Description
`vaultAddress`	Vault address
`vaultName`	Vault name
`equity`	Current equity in the vault
`pnl`	Profit and loss
`allTimePnl`	All-time PnL
`daysFollowing`	Days since entering the vault
`lockupUntil`	Lockup expiry (null if none)
`apy`	Estimated APY
`tvl`	Vault total value locked
`leader`	Vault leader address
`method`	`"HYPERLIQUID_API"` — fetched via Hyperliquid stats API

Full example

{
  "safeAddress": "0xSAFE…",
  "chainId": 42161,
  "operations": [
    {
      "type": "HYPERLIQUID_ENTER_VAULT",
      "hyperliquidData": {
        "action": "ENTER_VAULT",
        "amount": 1000
      }
    }
  ]
}