Skip to main content
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

FieldTypeNeedDescriptionExample
”account”stringrequiredUser’s wallet address (sender)42trU9A5…
“signature”stringrequiredCryptographic signature5j1Vy9Uq…
“timestamp”integerrequiredCurrent timestamp in milliseconds1716200000000
”to_account”stringrequiredDestination account address69trU9A5…
“symbol”stringrequiredSpot asset symbol (e.g. SOL)SOL
”amount”decimal stringrequiredAmount to transfer1.50000000
”idempotency_key”stringoptionalFull UUID. Prevents duplicate transfersf47ac10b-58cc-4372-a567-0e02b2c3d479
”agent_wallet”stringoptionalAgent wallet address69trU9A5…
“expiry_window”integeroptionalSignature expiry in milliseconds30000
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()