Skip to main content
POST
/
exchange
Transfer between spot and perp accounts
curl --request POST \
  --url https://api.hyperliquid.xyz/exchange \
  --header 'Content-Type: application/json' \
  --data '{
  "action": {
    "type": "spotUser",
    "classTransfer": {
      "usdc": "250.000000",
      "toPerp": true
    }
  },
  "nonce": 1705234567890,
  "signature": {
    "r": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
    "s": "0xfedcba0987654321fedcba0987654321fedcba0987654321fedcba0987654321",
    "v": 27
  },
  "vaultAddress": null
}'
{
  "status": "ok",
  "response": {
    "type": "spotUser",
    "data": {
      "status": "success"
    }
  }
}
This endpoint requires signature authentication. See our comprehensive Authentication via Signatures guide for implementation details.
Transfers USDC between your spot wallet and perpetual wallet on Hyperliquid. This allows you to move collateral between different trading modes without withdrawing from the platform.
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 perp
        • false — 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 subaccount
  • expiresAfter (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 successful
  • response — Contains transfer details:
    • type — "default"

​
Example request

# Transfer 100 USDC from spot to perp
curl -X POST https://api.hyperliquid.xyz/exchange \
  -H "Content-Type: application/json" \
  -d '{
    "action": {
      "type": "spotUser",
      "classTransfer": {
        "usdc": 100000000,
        "toPerp": true
      }
    },
    "nonce": 1234567890123,
    "signature": {...}
  }'

# Transfer 50 USDC from perp to spot
curl -X POST https://api.hyperliquid.xyz/exchange \
  -H "Content-Type: application/json" \
  -d '{
    "action": {
      "type": "spotUser",
      "classTransfer": {
        "usdc": 50000000,
        "toPerp": false
      }
    },
    "nonce": 1234567890123,
    "signature": {...}
  }'

​
Response example

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

​
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
​
action
object
required
​
nonce
integer
required

Current timestamp in milliseconds

​
signature
object
required

EIP-712 signature of the action with r, s, v components

​
vaultAddress
string

Address when trading on behalf of a vault or subaccount (optional)

Response

200 - application/json

Spot/Perp transfer result

​
status
string

Request status

​
response
object
⌘I