Skip to main content
POST
/
v1
/
exchange
/
transfer
Transfer USDC
curl --request POST \
  --url https://api.hypereth.io/v1/exchange/transfer \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "action": {
    "type": "usdTransfer",
    "hyperliquidChain": "Mainnet",
    "signatureChainId": "0xa4b1",
    "destination": "<string>",
    "amount": "<string>",
    "time": 123
  },
  "nonce": 123,
  "signature": {}
}'
{
  "status": "ok",
  "response": {
    "type": "usdTransfer",
    "data": {
      "hash": "<string>",
      "amount": "<string>",
      "destination": "<string>"
    }
  }
}

Authorizations

​
Authorization
string
header
required

Hyperliquid uses a custom signing scheme for authentication.

Required for: All /exchange endpoints

Format: Signature generated using private key + nonce + action data

Headers:

  • Authorization: Signature
  • Content-Type: application/json

Important Notes:

  • Use official SDKs to avoid signing errors
  • Nonce must be current timestamp in milliseconds
  • Address fields must be lowercase
  • Order of fields in msgpack serialization matters

Common Pitfalls:

  • Not understanding the two signing schemes
  • Trailing zeros on numbers
  • Case sensitivity on addresses
  • Incorrect field ordering

Body

application/json
​
action
object
required
​
nonce
integer
required
​
signature
object
required

Response

Transfer completed successfully

Transfer operation response

​
status
enum<string>
Available options:
ok,
err
​
response
object