# ChainHilt Send Asset Transfer Preview (Hyperliquid)

> ChainHilt Send Asset Transfer Preview (Hyperliquid) is a paid API for AI agents from chainhilt.ai, paid per call via x402, $0.001/call, status unknown (last checked 2026-11-16).

Prepares a user-signed EIP-712 sendAsset transfer payload for moving tokens between Hyperliquid accounts, subaccounts, spot, and perp DEXs — ready to sign and submit.

## Facts

- Endpoint: POST https://chainhilt.ai/api/v1/perp/hyperliquid/send-asset/preview?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/chainhilt-send-asset-transfer-preview-hyperliquid-62d6f7c1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_1TMgnEAtBxWtten0-cL6g

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability chainhilt-send-asset-transfer-preview-hyperliquid-62d6f7c1 -d '<json body>'
```

Example prompt: Prepare a Hyperliquid sendAsset transfer of 1.5 USDC (token USDC:0x6d1e7cde53ba9467b783cb7c530ce054) from my perp DEX balance to address 0x1111111111111111111111111111111111111111's spot balance, using my main account, so I can sign and submit it.

## When to prefer this

Use this endpoint when you need to move tokens between Hyperliquid accounts, subaccounts, spot, and perp DEX balances and require an EIP-712 signed payload ready for wallet signing and on-chain submission. Prefer this over raw Hyperliquid API calls when you want a structured preview with validation, error handling, and a ready-made submitPath — especially in an x402 agent workflow with no API key management.

## Known failure modes

- 400 Bad Request: invalid input (bad token format, negative amount, malformed address, invalid sourceDex/destinationDex enum)
- 422 Unprocessable Entity: transfer rejected at execution time (insufficient balance, invalid subaccount, unsupported cross-DEX transfer)
- 502 Bad Gateway: upstream Hyperliquid provider failure
- Spot-perp unified balance misuse: treating spot and perp as one balance when account abstraction mode is not 'unifiedAccount'
- Missing collateral token: perp DEX transfers require the collateral token to be specified

## How this service works

Discover, pay for, and execute the on-chain actions your agent needs. No API keys. Compatible with x402. Your wallet stays local.

## Output

Returns a JSON object containing an actions array with one entry: a 'signature' type action holding the full EIP-712 typed data (domain, message, types, primaryType), the raw action object, the nonce, chainId, protocol ('hyperliquid'), and a submitPath pointing to the execute endpoint. Also includes any errors or warnings from validation. The caller must sign the typedData with their main wallet and POST the unchanged payload to the submitPath.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "nonce": {
   "type": "integer",
   "minimum": 0,
   "description": "Action nonce in milliseconds since the epoch; defaults to the current time."
  },
  "token": {
   "type": "string",
   "pattern": "^[^:\\s]+:0x[0-9a-fA-F]{32}$",
   "description": "tokenName:tokenId, e.g. \"USDC:0x6d1e7cde53ba9467b783cb7c530ce054\". Perp DEX transfers need its collateral token."
  },
  "amount": {
   "type": "string",
   "pattern": "^(0|[1-9][0-9]*)(\\.[0-9]+)?$",
   "description": "Positive decimal amount in token units, e.g. \"1.5\"."
  },
  "sourceDex": {
   "enum": [
    "",
    "spot"
   ],
   "type": "string",
   "description": "Balance to send from: \"\" for the default perp DEX or \"spot\"."
  },
  "destination": {
   "type": "string",
   "pattern": "^0x[a-fA-F0-9]{40}$",
   "description": "Recipient address on Hyperliquid."
  },
  "destinationDex": {
   "type": "string",
   "description": "Balance to credit: \"\" for the default perp DEX, \"spot\", or a named perp DEX."
  },
  "fromSubAccount": {
   "anyOf": [
    {
     "type": "string",
     "const": ""
    },
    {
     "type": "string",
     "pattern": "^0x[a-fA-F0-9]{40}$"
    }
   ],
   "default": "",
   "description": "\"\" for the main account, or the subaccount address to send from."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "response": {
   "errors": [],
   "actions": [
    {
     "data": {
      "nonce": 1710000000000,
      "action": {
       "type": "sendAsset",
       "nonce": 1710000000000,
       "token": "USDC:0x6d1e7cde53ba9467b783cb7c530ce054",
       "amount": "1",
       "sourceDex": "",
       "destination": "0x1111111111111111111111111111111111111111",
       "destinationDex": "spot",
       "fromSubAccount": "",
       "hyperliquidChain": "Mainnet",
       "signatureChainId": "0xa4b1"
      },
      "typedData": {
       "types": {
        "EIP712Domain": [
         {
          "name": "name",
          "type": "string"
         },
         {
          "name": "version",
          "type": "string"
         },
         {
          "name": "chainId",
          "type": "uint256"
         },
         {
          "name": "verifyingContract",
          "type": "address"
         }
        ],
        "HyperliquidTransaction:SendAsset": [
         {
          "name": "hyperliquidChain",
          "type": "string"
         },
         {
          "name": "destination",
          "type": "string"
         },
         {
          "name": "sourceDex",
          "type": "string"
         },
         {
          "name": "destinationDex",
          "type": "string"
         },
         {
          "name": "token",
          "type": "string"
         },
         {
          "name": "amount",
          "type": "string"
         },
         {
          "name": "fromSubAccount",
          "type": "string"
         },
         {
          "name": "nonce",
          "type": "uint64"
         }
        ]
       },
       "domain": {
        "name": "HyperliquidSignTransaction",
        "chainId": 42161,
        "version": "1",
        "verifyingContract": "0x0000000000000000000000000000000000000000"
       },
       "message": {
        "type": "sendAsset",
        "nonce": 1710000000000,
        "token": "USDC:0x6d1e7cde53ba9467b783cb7c530ce054",
        "amount": "1",
        "sourceDex": "",
        "destination": "0x1111111111111111111111111111111111111111",
        "destinationDex": "spot",
        "fromSubAccount": "",
        "hyperliquidChain": "Mainnet",
        "signatureChainId": "0xa4b1"
       },
       "primaryType": "HyperliquidTransaction:SendAsset"
      }
     },
     "type": "signature",
     "chainId": 42161,
     "protocol": "hyperliquid",
     "submitPath": "/perp/hyperliquid/send-asset/execute"
    }
   ],
   "warnings": []
  
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/chainhilt-send-asset-transfer-preview-hyperliquid-62d6f7c1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from chainhilt.ai](https://www.zero.xyz/host/chainhilt.ai/llms.txt)
