This endpoint requires signature authentication. See our comprehensive Authentication via Signatures guide for implementation details.
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.
Parameters
Required parameters
-
action
(object, required) — The transfer action object containing:type
(string) — Must be"spotUser"
classTransfer
(object) — Transfer details:usdc
(number) — Amount to transfer in USDC with 6 decimals (e.g., 100000000 = 100 USDC)toPerp
(boolean) — Direction of transfer:true
— Transfer from spot to perpfalse
— Transfer from perp to spot
-
nonce
(number, required) — Current timestamp in milliseconds (must be recent) -
signature
(object, required) — EIP-712 signature of the action
Optional parameters
vaultAddress
(string, optional) — Address when trading on behalf of a vault or subaccountexpiresAfter
(number, optional) — Timestamp in milliseconds after which the request is rejected
Transfer direction
-
Spot → Perp (
toPerp: true
)- Moves USDC from spot wallet to perpetual trading account
- Required for perpetual trading and margin
-
Perp → Spot (
toPerp: false
)- Moves USDC from perpetual account to spot wallet
- Required for spot trading or token purchases
Returns
Returns an object with transfer status:status
—"ok"
if successfulresponse
— Contains transfer details:type
—"default"
Example request
Response example
Important considerations
- Balance requirements — Must have sufficient balance in the source wallet
- Instant transfer — Transfers are immediate within Hyperliquid
- No fees — Internal transfers between spot and perp are free
- Position checks — Cannot transfer from perp if it would cause liquidation
Use cases
- Trading mode switch — Move funds between spot and perpetual trading
- Capital allocation — Optimize fund distribution across trading strategies
- Risk management — Move profits from perp to spot for safer storage
- Liquidity management — Quickly reallocate capital based on opportunities
USDC in the spot wallet can be used for spot trading and token purchases. USDC in the perp wallet is used as collateral for perpetual positions.
When transferring from perp to spot, ensure you maintain sufficient margin for any open perpetual positions to avoid liquidation.
Body
application/json