Exchange API calls do not consume Quicknode API credits. Transactions through this endpoint are appended with a builder fee. See hyperliquidapi.com for a full breakdown. To white-label with your own builder code, contact us.
Body Parameters
- actionobjectREQUIRED
Action object. The type field determines which operation is performed and which additional fields are required.
- typestring
Action type. Supported values: "usdSend" (transfer USDC), "spotSend" (transfer spot token), "usdClassTransfer" (move USDC between spot and perp), "withdraw3" (withdraw to L1), "approveAgent" (approve API wallet), "tokenDelegate" (delegate/undelegate staking), "cWithdraw" (withdraw from undelegated staking balance), "sendAsset", "userSetAbstraction"
- destinationstring
Recipient address (0x-prefixed). Required for usdSend, spotSend, withdraw3.
- amountstring
Amount as a decimal string. Required for usdSend, spotSend, usdClassTransfer, withdraw3.
- tokenstring
Token identifier in "NAME:address" format (e.g. "HYPE:0x0d01dc56dcaaca66ad901c959b4011ec"). Required for spotSend.
- toPerpboolean
Direction for usdClassTransfer: true moves USDC from spot to perp, false moves perp to spot.
- agentAddressstring
Agent wallet address to approve. Required for approveAgent.
- agentNamestring
Human-readable name for the agent. Required for approveAgent.
- validatorstring
Validator address. Required for tokenDelegate.
- weiinteger
Amount in wei (8 decimals). Required for cWithdraw and tokenDelegate.
- isUndelegateboolean
If true, undelegates tokens. If false, delegates. Required for tokenDelegate.
Returns
- hashstring
Hash to sign with wallet (0x-prefixed hex string)
- nonceinteger
Unique nonce for this action (timestamp in milliseconds)
- actionobject
Wire-format action with hyperliquidChain and signatureChainId injected automatically
- actionTypestring
The action type as submitted (e.g. "usdSend", "withdraw3")
- typedDataobject
Full EIP-712 typed data for signing. The primaryType is HyperliquidTransaction:<ActionType> (e.g. HyperliquidTransaction:UsdSend).
- domainobject
EIP-712 domain: name (HyperliquidSignTransaction), version, chainId, verifyingContract
- typesobject
EIP-712 type definitions specific to the action type
- primaryTypestring
e.g. "HyperliquidTransaction:UsdSend"
- messageobject
The message to sign. Fields vary by action type.
- nextStepstring
Instructions: sign the hash with private key, then POST /exchange with action, nonce, and signature (r, s, v)