๐Ÿ”Œ API & Developers

Hyperliquid vaultTransfer API: Deposit or Withdraw Vault Funds via POST /exchange

โš ๏ธ Disclosure: Some links on this page are affiliate links. If you sign up through them, I may earn a commission โ€” at no extra cost to you.
The documented action for adding or removing funds from a Hyperliquid vault is vaultTransfer. It is sent to POST https://api.hyperliquid.xyz/exchange with a JSON body that includes the action, nonce, and signature. The action object requires vaultAddress, isDeposit, and usd; expiresAfter is optional.

This article uses the documented request shape from the Hyperliquid exchange-endpoint docs. It is not a live-account test.

Endpoint and signing

Use:

The exchange endpoint is used to interact with and trade on the Hyperliquid chain. The docs point to the Python SDK for code that generates signatures for these requests.

Vaults and subaccounts do not have private keys. To perform actions on behalf of a subaccount or vault, the docs say signing should be done by the master account and the vault address should be supplied. For vaultTransfer, the vault address is inside the action object as action.vaultAddress. The Python SDK includes a basic_vault.py example that demonstrates vault actions.

The request body also includes:

vaultTransfer request fields

FieldTypeRequiredDescription
action.typeStringYesUse "vaultTransfer".
action.vaultAddressStringYesVault address in 42-character hexadecimal format.
action.isDepositBooleanYesDirection of the transfer; the documented action is for depositing into or withdrawing from a vault.
action.usdNumberYesAmount field documented as usd.
nonceNumberYesRecommended current timestamp in milliseconds.
signatureObjectYesSDK-generated signature object.
expiresAfterNumberNoOptional deadline in milliseconds.
The action object has this documented shape:

{
  "type": "vaultTransfer",
  "vaultAddress": "0x0000000000000000000000000000000000000000",
  "isDeposit": true,
  "usd": 100
}

Wrap that object in the request body with nonce and signature. The usd field is documented as a number, unlike several other transfer actions that use string amounts.

Expected response

The documented successful response is:

{
  "status": "ok",
  "response": {
    "type": "default"
  }
}

๐Ÿ’ก Hyperliquid

Like what you're reading? Try it yourself โ€” this link supports ChartedTrader at no cost to you.

Sign up on Hyperliquid โ†’
๐ŸŽ You receive: 4% fee discount on first $25M volume ยท per account, lifetime

Difference from hip3LiquidatorTransfer

hip3LiquidatorTransfer is a separate action for adding or removing funds from an HIP-3 DEX's backstop liquidator address. It uses the same POST https://api.hyperliquid.xyz/exchange endpoint and also supports nonce, signature, and optional expiresAfter.

AspectvaultTransferhip3LiquidatorTransfer
Action type"vaultTransfer""hip3LiquidatorTransfer"
Target fieldvaultAddress: 42-character hexadecimal vault addressdex: string, e.g. "xyz"
Amount fieldusd: numberntl: integer in units of 1e-6 quote tokens
Amount constraintNot specified in this sourceMust be a multiple of 1000 quote tokens, i.e. ntl % 1000000000 == 0
Direction fieldisDeposit: booleanisDeposit: boolean
Optional deadlineexpiresAfter supportedexpiresAfter supported
Documented response{"status": "ok", "response": {"type": "default"}}{"status": "ok", "response": {"type": "default"}}
Withdrawal scopeDocumented as adding or removing funds from a vaultOnly principal amount is withdrawable, not PnL
The hip3LiquidatorTransfer action object has this documented shape:

{
  "type": "hip3LiquidatorTransfer",
  "dex": "xyz",
  "ntl": 1000000000,
  "isDeposit": false
}

In that example, 1000000000 represents 1,000 quote tokens because ntl uses 1e-6 quote-token units.

CTA

The Hyperliquid link below is a referral link; supa.is may earn a commission or referral reward. Sign up on Hyperliquid

Continue with Hyperliquid

Browse the Hyperliquid guide hub for the complete user journey.

Official reference: Hyperliquid documentation.

๐Ÿงฎ Free Hyperliquid calculators

Fee Calculator โ†’
Hyperliquid vs centralized exchange fee comparison
PnL & Liquidation โ†’
Perp PnL + liquidation price
Position Size โ†’
Risk-aware position sizing for HL perps
Hyperliquid

Ready to get started? Use the link below โ€” it helps support ChartedTrader at no cost to you.

Sign up on Hyperliquid โ†’
๐ŸŽ You receive: 4% fee discount on first $25M volume ยท per account, lifetime
๐Ÿ“ˆ

About the author

I'm a systematic trader running live strategies on IB (USDJPY momentum) and Hyperliquid (crypto perps). Questions? Reach out.

๐Ÿ“š Related Articles

๐Ÿ”ง
Troubleshooting & Fixes

Hyperliquid Python SDK: Checksummed Address Signature Rejections in vault_usd_transfer (2026)

A reported Hyperliquid Python SDK issue: checksummed addresses in vault_usd_transfer and sub-account transfers can cause signature rejection; use lowercase addresses.

November 15, 2026 โฑ 3 min read
๐Ÿ”Œ
API & Developers

Hyperliquid updateLeverage and updateIsolatedMargin API: Exchange Endpoint Reference

Reference for Hyperliquid's updateLeverage, updateIsolatedMargin, and topUpIsolatedOnlyMargin exchange actions: schemas, fields, and signed request structure.

November 16, 2026 โฑ 3 min read
๐Ÿ”ง
Troubleshooting & Fixes

Hyperliquid SDK: HIP-3 dex Param Fix (2026)

The Hyperliquid Python SDK drops the HIP-3 dex parameter on user_state, open_orders, and all_mids. Here's what breaks, why it happens, and the fix path based on GitHub issue #286.

September 8, 2026 โฑ 9 min read