Subaccount Spot Transfer

Please refer to the Python SDK for a comprehensive guide on subaccount spot transfer via API

POST /api/v1/account/subaccount/spot_asset/transfer

Request Body

Field	Type	Need	Description	Example
`”account”`	string	required	User’s wallet address (sender)	`42trU9A5…`
`“signature”`	string	required	Cryptographic signature	`5j1Vy9Uq…`
`“timestamp”`	integer	required	Current timestamp in milliseconds	`1716200000000`
`”to_account”`	string	required	Destination account address	`69trU9A5…`
`“symbol”`	string	required	Spot asset symbol (e.g. SOL)	`SOL`
`”amount”`	decimal string	required	Amount to transfer	`1.50000000`
`”idempotency_key”`	string	optional	Full UUID. Prevents duplicate transfers	`f47ac10b-58cc-4372-a567-0e02b2c3d479`
`”agent_wallet”`	string	optional	Agent wallet address	`69trU9A5…`
`“expiry_window”`	integer	optional	Signature expiry in milliseconds	`30000`

The signature must be generated using the operation type "transfer_spot_asset".

{
  "account": "42trU9A5...",
  "signature": "5j1Vy9Uq...",
  "timestamp": 1716200000000,
  "to_account": "69trU9A5...",
  "symbol": "SOL",
  "amount": "1.50000000",
  "idempotency_key": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "agent_wallet": "69trU9A5...",
  "expiry_window": 30000
}

The destination account must be a subaccount of the sender, or the sender must be a subaccount transferring to its parent.

Response

Status 200: Transfer completed successfully

Status Code: 200
{
  "success": true,
  "data": {
    "success": true,
    "error": null
  },
  "error": null,
  "code": null
}

Status 409: Duplicate idempotency key
Status 500: Internal server error

Code Example (Python)

import requests

payload = {
    "account": "42trU9A5...",
    "signature": "5j1Vy9Uq...",
    "timestamp": 1716200000000,
    "to_account": "69trU9A5...",
    "symbol": "SOL",
    "amount": "1.50000000",
    "idempotency_key": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "agent_wallet": "69trU9A5...",
    "expiry_window": 30000,
}

response = requests.post(
    "/api/v1/account/subaccount/spot_asset/transfer",
    headers={"Accept": "*/*", "Content-Type": "application/json"},
    json=payload,
)

data = response.json()

​Request Body

​Response

​Code Example (Python)

Request Body

Response

Code Example (Python)