> ## Documentation Index
> Fetch the complete documentation index at: https://chainstack-docs-polygon-erigon-trace-deprecation.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Spot token transfer | Hyperliquid exchange

> Transfers spot tokens directly to another address on the Hyperliquid chain. Spot token transfer on Hyperliquid exchange via Chainstack.

<Info>
  You can only use this endpoint on the official Hyperliquid public API. It is not available through Chainstack, as the open-source node implementation does not support it yet. See [Hyperliquid methods](/docs/hyperliquid-methods) for the full availability breakdown.
</Info>

<Note>
  This endpoint requires signature authentication. See our comprehensive [Authentication via Signatures guide](/docs/hyperliquid-authentication-guide) for implementation details.
</Note>

Transfers spot tokens directly to another address on the Hyperliquid chain. This is an internal transfer that doesn't interact with the EVM bridge and uses a human-readable signature format for wallet interfaces.

## Parameters

### Required parameters

* `action` (object, required) — The spot send action object containing:
  * `type` (string) — Must be `"spotSend"`
  * `hyperliquidChain` (string) — `"Mainnet"` for mainnet, `"Testnet"` for testnet
  * `signatureChainId` (string) — Chain ID used for signing in hex format (e.g., `"0xa4b1"` for Arbitrum)
  * `destination` (string) — Recipient address in 42-character hexadecimal format
  * `token` (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:

```json theme={null}
{
  "types": {
    "HyperliquidTransaction:SpotSend": [
      {"name": "hyperliquidChain", "type": "string"},
      {"name": "destination", "type": "string"},
      {"name": "token", "type": "string"},
      {"name": "amount", "type": "string"},
      {"name": "time", "type": "uint64"}
    ]
  },
  "primaryType": "HyperliquidTransaction:SpotSend",
  "domain": {
    "name": "HyperliquidSignTransaction",
    "version": "1",
    "chainId": 42161,
    "verifyingContract": "0x0000000000000000000000000000000000000000"
  },
  "message": {
    "hyperliquidChain": "Mainnet",
    "destination": "0x...",
    "token": "PURR:0xc1fb593aeffbeb02f85e0308e9956a90",
    "amount": "100.0",
    "time": 1234567890123
  }
}
```

## Returns

Returns an object with transfer status:

* `status` — `"ok"` if successful
* `response` — Contains transfer details:
  * `type` — `"default"`

## Example request

<CodeGroup>
  ```shell cURL theme={null}
  curl -X POST https://api.hyperliquid.xyz/exchange \
    -H "Content-Type: application/json" \
    -d '{
      "action": {
        "type": "spotSend",
        "hyperliquidChain": "Mainnet",
        "signatureChainId": "0xa4b1",
        "destination": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb0",
        "token": "PURR:0xc1fb593aeffbeb02f85e0308e9956a90",
        "amount": "100.0",
        "time": 1234567890123
      },
      "nonce": 1234567890123,
      "signature": {...}
    }'
  ```

  ```python Python (hyperliquid-python-sdk) theme={null}
  from hyperliquid.exchange import Exchange
  from hyperliquid.utils import constants
  import eth_account

  # Initialize with your private key
  account = eth_account.Account.from_key("0x...")
  exchange = Exchange(account, constants.MAINNET_API_URL)

  # Send 100 PURR tokens to another address (signs and posts a spotSend action)
  transfer_result = exchange.spot_transfer(
      amount=100.0,
      destination="0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb0",
      token="PURR:0xc1fb593aeffbeb02f85e0308e9956a90",
  )

  print(transfer_result)
  ```

  ```typescript TypeScript (@nktkas/hyperliquid) theme={null}
  import { ExchangeClient, HttpTransport } from "@nktkas/hyperliquid";
  import { privateKeyToAccount } from "viem/accounts";

  // Initialize with your private key
  const wallet = privateKeyToAccount("0x...");
  const transport = new HttpTransport(); // default public Hyperliquid API
  const exchange = new ExchangeClient({ transport, wallet });

  // Send 100 PURR tokens to another address (signs and posts a spotSend action)
  const transferResult = await exchange.spotSend({
    destination: "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb0",
    token: "PURR:0xc1fb593aeffbeb02f85e0308e9956a90",
    amount: "100.0",
  });

  console.log(transferResult);
  ```
</CodeGroup>

## Response example

```json theme={null}
{
  "status": "ok",
  "response": {
    "type": "default"
  }
}
```

## 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

<Note>
  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.
</Note>

<Warning>
  Always verify both the destination address and token ID. Transfers are irreversible once confirmed on the Hyperliquid chain.
</Warning>


## OpenAPI

````yaml openapi/hyperliquid_node_api/hypercore_exchange/exchange_spot_send.json post /exchange
openapi: 3.0.0
info:
  title: Hyperliquid Exchange API
  version: 1.0.0
  description: >-
    API for trading operations on Hyperliquid exchange requiring authentication.
    ⚠️ WARNING: These endpoints require EIP-712 signatures for authentication.
    The example values provided will NOT work without proper cryptographic
    signing. You must implement EIP-712 signing to use these endpoints
    successfully.
servers:
  - url: https://api.hyperliquid.xyz
security: []
paths:
  /exchange:
    post:
      tags:
        - hyperliquid exchange
      summary: Transfer spot token
      operationId: transferSpotToken
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                action:
                  type: object
                  properties:
                    type:
                      type: string
                      default: spotSend
                      enum:
                        - spotSend
                      description: Action type
                    hyperliquidChain:
                      type: string
                      description: Chain identifier
                      default: Mainnet
                      enum:
                        - Mainnet
                        - Testnet
                    signatureChainId:
                      type: string
                      description: EIP-712 signature chain ID
                      default: '0xa4b1'
                    destination:
                      type: string
                      description: Recipient Ethereum address
                    token:
                      type: string
                      description: Token identifier with index (e.g., "PURR:0x1")
                    amount:
                      type: string
                      description: Amount to send as a decimal string
                    time:
                      type: integer
                      description: Current timestamp in milliseconds
                  required:
                    - type
                    - hyperliquidChain
                    - signatureChainId
                    - destination
                    - token
                    - amount
                    - time
                nonce:
                  type: integer
                  description: Current timestamp in milliseconds
                signature:
                  type: object
                  description: EIP-712 signature of the action with r, s, v components
                  properties:
                    r:
                      type: string
                      description: ECDSA signature r component (hex string)
                      example: >-
                        0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef
                    s:
                      type: string
                      description: ECDSA signature s component (hex string)
                      example: >-
                        0xfedcba0987654321fedcba0987654321fedcba0987654321fedcba0987654321
                    v:
                      type: integer
                      description: ECDSA recovery id (27 or 28)
                      example: 27
                  required:
                    - r
                    - s
                    - v
                vaultAddress:
                  type: string
                  description: >-
                    Address when trading on behalf of a vault or subaccount
                    (optional)
                  nullable: true
              required:
                - action
                - nonce
                - signature
            example:
              action:
                type: spotSend
                hyperliquidChain: Mainnet
                signatureChainId: '0xa4b1'
                destination: '0x1234567890abcdef1234567890abcdef12345678'
                token: PURR:0x1
                amount: '100.0'
                time: 1705234567890
              nonce: 1705234567890
              signature:
                r: >-
                  0x0000000000000000000000000000000000000000000000000000000000000000
                s: >-
                  0x0000000000000000000000000000000000000000000000000000000000000000
                v: 27
              vaultAddress: null
      responses:
        '200':
          description: Spot token transfer result
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    description: Request status
                  response:
                    type: object
                    properties:
                      type:
                        type: string
                      data:
                        type: object
                        properties:
                          status:
                            type: string
                            description: Transfer status
                example:
                  status: ok
                  response:
                    type: spotSend
                    data:
                      status: success

````