Skip to main content

Build User-Signed Action REST API Endpoint

Build a user-signed (HyperliquidTransaction EIP-712) action. Covers transfers, withdrawals, staking, and account management operations. Returns EIP-712 typed data to sign.

Updated on
May 19, 2026
info

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

action
object
REQUIRED

Action object. The type field determines which operation is performed and which additional fields are required.

type
string

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"

destination
string

Recipient address (0x-prefixed). Required for usdSend, spotSend, withdraw3.

amount
string

Amount as a decimal string. Required for usdSend, spotSend, usdClassTransfer, withdraw3.

token
string

Token identifier in "NAME:address" format (e.g. "HYPE:0x0d01dc56dcaaca66ad901c959b4011ec"). Required for spotSend.

toPerp
boolean

Direction for usdClassTransfer: true moves USDC from spot to perp, false moves perp to spot.

agentAddress
string

Agent wallet address to approve. Required for approveAgent.

agentName
string

Human-readable name for the agent. Required for approveAgent.

validator
string

Validator address. Required for tokenDelegate.

wei
integer

Amount in wei (8 decimals). Required for cWithdraw and tokenDelegate.

isUndelegate
boolean

If true, undelegates tokens. If false, delegates. Required for tokenDelegate.

Returns

hash
string

Hash to sign with wallet (0x-prefixed hex string)

nonce
integer

Unique nonce for this action (timestamp in milliseconds)

action
object

Wire-format action with hyperliquidChain and signatureChainId injected automatically

actionType
string

The action type as submitted (e.g. "usdSend", "withdraw3")

typedData
object

Full EIP-712 typed data for signing. The primaryType is HyperliquidTransaction:<ActionType> (e.g. HyperliquidTransaction:UsdSend).

domain
object

EIP-712 domain: name (HyperliquidSignTransaction), version, chainId, verifyingContract

types
object

EIP-712 type definitions specific to the action type

primaryType
string

e.g. "HyperliquidTransaction:UsdSend"

message
object

The message to sign. Fields vary by action type.

nextStep
string

Instructions: sign the hash with private key, then POST /exchange with action, nonce, and signature (r, s, v)

Request
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free