๐Ÿ”Œ API & Developers

Hyperliquid sendAsset and agentSendAsset: Perp/Spot Transfer Request Fields

โš ๏ธ Disclosure: Some links on this page are affiliate links. If you sign up through them, I may earn a commission โ€” at no extra cost to you.
Hyperliquid's sendAsset and agentSendAsset actions are POST requests to https://api.hyperliquid.xyz/exchange for moving tokens between perp DEX balances, spot balances, users, and/or subaccounts. If you need an account for API work, create a Hyperliquid account (referral link; supa.is may receive a referral reward). The field reference below is from the Hyperliquid exchange endpoint documentation as of 2026-11-17.

Shared request shape

Both actions use the same endpoint and the same Content-Type: application/json header.

FieldTypeRequirement
actionObjectRequired. Contains the action type and action-specific fields.
nonceNumberRequired. Recommended value is the current timestamp in milliseconds. It must match action.nonce.
signatureObjectRequired.
The documentation describes sendAsset as a generalized method for transferring tokens between different perp DEXs, spot balance, users, and/or subaccounts. It also states that only the collateral token can be transferred to or from a perp DEX.

sendAsset fields

sendAsset is the user-signed transfer action. Its documented action object includes:

FieldType / valueMeaning
type"sendAsset"Action type.
hyperliquidChain"Mainnet" or "Testnet"Hyperliquid chain target. Use "Testnet" on testnet.
signatureChainIdHex stringChain ID used when signing, in hexadecimal format. The docs give "0xa4b1" for Arbitrum as an example.
destination42-character hexadecimal addressRecipient address.
sourceDexPerp DEX name, "", or "spot"Perp DEX to transfer from. Use "" for the default USDC perp DEX and "spot" for spot.
destinationDexPerp DEX name, "", or "spot"Perp DEX to transfer to. Use "" for the default USDC perp DEX and "spot" for spot.
tokentokenName:tokenIdToken identifier. The docs use "PURR:0xc4bf3f870c0e9465323c0b6ed28096c2" as an example.
amountStringAmount of token to send, for example "0.01".
fromSubAccount42-character hexadecimal address or ""Subaccount address, or empty string if not transferring from a subaccount.
nonceNumberCurrent timestamp in milliseconds. It should match the outer nonce.

agentSendAsset fields

agentSendAsset is similar to sendAsset, but it can be signed by an agent. The documented action object includes:

FieldType / valueMeaning
type"agentSendAsset"Action type.
destination42-character hexadecimal addressRecipient address. The docs state that the destination must match the source address.
sourceDexPerp DEX name, "", or "spot"Perp DEX to transfer from. Use "" for the default USDC perp DEX and "spot" for spot.
destinationDexPerp DEX name, "", or "spot"Perp DEX to transfer to. Use "" for the default USDC perp DEX and "spot" for spot.
tokentokenName:tokenIdToken identifier.
amountStringAmount of token to send.
fromSubAccount42-character hexadecimal address or ""Subaccount address, or empty string if not transferring from a subaccount.
nonceNumberCurrent timestamp in milliseconds. It should match the outer nonce.
The documented agentSendAsset action object does not include hyperliquidChain or signatureChainId.

Key differences

For agent-wallet context, see Hyperliquid API Agent Wallet Setup & Permissions (2026).

Example action objects

These are illustrative shapes using placeholder values for the schema fields; they are not a valid transfer. The documentation states that only the collateral token can be transferred to or from a perp DEX, so when sourceDex or destinationDex names a perp DEX (including "" for the default USDC perp DEX), token must be that DEX's collateral token rather than an arbitrary spot token such as PURR. Substitute a valid collateral token and real addresses before sending a request. The full request body also needs the outer nonce and signature.

sendAsset action (field-shape example only, not a valid transfer):

{
  "type": "sendAsset",
  "hyperliquidChain": "Mainnet",
  "signatureChainId": "0xa4b1",
  "destination": "0x0000000000000000000000000000000000000000",
  "sourceDex": "<perp-dex-name-or-empty-or-spot>",
  "destinationDex": "<perp-dex-name-or-empty-or-spot>",
  "token": "<tokenName:tokenId>",
  "amount": "0.01",
  "fromSubAccount": "",
  "nonce": 1763333333333
}

agentSendAsset action (field-shape example only, not a valid transfer):

{
  "type": "agentSendAsset",
  "destination": "0x0000000000000000000000000000000000000000",
  "sourceDex": "<perp-dex-name-or-empty-or-spot>",
  "destinationDex": "<perp-dex-name-or-empty-or-spot>",
  "token": "<tokenName:tokenId>",
  "amount": "0.01",
  "fromSubAccount": "",
  "nonce": 1763333333333
}

๐Ÿ’ก Hyperliquid

Like what you're reading? Try it yourself โ€” this link supports ChartedTrader at no cost to you.

Create a Hyperliquid account โ†’
๐ŸŽ You receive: 4% fee discount on first $25M volume ยท per account, lifetime

Default success response

The documented 200: OK response for both actions is:

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

Scope

This reference covers only the documented request fields and default response for sendAsset and agentSendAsset. It does not document cross-chain withdrawal behavior, fees, or settlement timing for these actions. For broader API error handling, see Hyperliquid API Error Responses: Troubleshooting Guide (2026).

Create an account

If you are building against the Hyperliquid exchange endpoint, you can create a Hyperliquid account. This is a referral link; supa.is may receive a referral reward.

Continue with Hyperliquid

Browse the Hyperliquid guide hub for the complete user journey.

๐Ÿงฎ Free Hyperliquid calculators

Fee Calculator โ†’
Hyperliquid vs centralized exchange fee comparison
PnL & Liquidation โ†’
Perp PnL + liquidation price
Position Size โ†’
Risk-aware position sizing for HL perps
Hyperliquid

Ready to get started? Use the link below โ€” it helps support ChartedTrader at no cost to you.

Create a Hyperliquid account โ†’
๐ŸŽ You receive: 4% fee discount on first $25M volume ยท per account, lifetime
๐Ÿ“ˆ

About the author

I'm a systematic trader running live strategies on IB (USDJPY momentum) and Hyperliquid (crypto perps). Questions? Reach out.

๐Ÿ“š Related Articles

๐Ÿ”Œ
API & Developers

Hyperliquid cWithdraw: Withdraw Native Tokens From Staking (7-Day Unstaking Queue)

The Hyperliquid cWithdraw action moves native tokens from staking to your spot account. Transfers enter a 7-day unstaking queue before the spot balance is available.

November 14, 2026 โฑ 2 min read
๐Ÿ”Œ
API & Developers

Hyperliquid cDeposit and tokenDelegate API: Deposit Native Tokens into Staking and Delegate to Validators

Use POST /exchange cDeposit and tokenDelegate to move native tokens into staking and delegate them to validators. Fields, agent cDeposit2, 1-day lockup, and responses.

November 16, 2026 โฑ 4 min read
๐Ÿ”Œ
API & Developers

Hyperliquid vaultTransfer API: Deposit or Withdraw Vault Funds via POST /exchange

Use Hyperliquid's vaultTransfer action on POST /exchange to add or remove vault funds. Covers vaultAddress, isDeposit, usd, expiresAfter, response, and hip3LiquidatorTransfer differences.

November 16, 2026 โฑ 3 min read