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 spot send action object containing:type
(string) — Must be"spotSend"
hyperliquidChain
(string) —"Mainnet"
for mainnet,"Testnet"
for testnetsignatureChainId
(string) — Chain ID used for signing in hex format (e.g.,"0xa4b1"
for Arbitrum)destination
(string) — Recipient address in 42-character hexadecimal formattoken
(string) — Token identifier in format"TOKEN_NAME:TOKEN_ID"
(e.g.,"PURR:0xc1fb593aeffbeb02f85e0308e9956a90"
)amount
(string) — Amount of tokens to send (e.g.,"100.5"
)time
(number) — Current timestamp in milliseconds (must match nonce)
-
nonce
(number, required) — Current timestamp in milliseconds (must match action.time) -
signature
(object, required) — EIP-712 signature of the action
Token format
The token parameter must include both the token name and its ID:- Format:
"TOKEN_NAME:TOKEN_ID"
- Example:
"PURR:0xc1fb593aeffbeb02f85e0308e9956a90"
- The token ID can be found in the spot metadata response
Signature format
This endpoint uses EIP-712 typed data signing with a human-readable format:Returns
Returns an object with transfer status:status
—"ok"
if successfulresponse
— Contains transfer details:type
—"default"
Example request
Response example
Important notes
- Spot tokens only — This endpoint is for spot tokens, not perpetual positions
- Token balance required — Must have sufficient token balance
- Internal transfers only — Doesn’t interact with external bridges
- Instant settlement — Transfers are immediate within Hyperliquid
Use cases
- Token distribution — Send tokens to multiple recipients
- P2P transfers — Direct token transfers between users
- Vault operations — Move tokens to/from vault addresses
- Airdrops — Programmatic token distribution
You need to know the token ID for the transfer. This can be obtained from the spot metadata endpoint or by checking existing token balances.
Always verify both the destination address and token ID. Transfers are irreversible once confirmed on the Hyperliquid chain.
Body
application/json