Withdraw spot asset

This endpoint allows users to withdraw a spot asset.

POST /api/v1/account/spot_asset/withdraw

The operation type for signing is "withdraw_spot_asset".

Request Body

Field	Type	Need	Description	Example
"account"	string	required	User's wallet address	42trU9A5...
"signature"	string	required	Cryptographic signature	5J3mBbAH...
"timestamp"	integer	required	Current timestamp in milliseconds	1716200000000
"symbol"	string	required	Spot asset symbol	SOL
"amount"	string	required	Amount to withdraw	1.00000000
"idempotency_key"	string	optional	Full UUID string. Prevents duplicate withdrawals	550e8400-e29b-41d4-a716-446655440000
"agent_wallet"	string	optional	Agent wallet address	8zFqj1Kp...
"expiry_window"	integer	optional	Signature expiry in milliseconds	10000

Response

• Status 200: Successfully submitted withdrawal

{
  "success": true,
  "data": {
    "symbol": "SOL",
    "batch_nonce": 42,
    "requested_amount": "1.00000000",
    "fee_amount": "0.00100000"
  }
}

Field	Type	Description
'symbol'	string	Spot asset symbol
'batch_nonce'	integer	Nonce of the withdrawal batch
'requested_amount'	decimal string	Amount requested for withdrawal
'fee_amount'	decimal string	Fee deducted from the withdrawal

• Status 400: Invalid request parameters

• Status 401: Unauthorized access

• Status 409: Duplicate idempotency key

• Status 500: Internal server error

Code Example (Python)

import requests

payload = {
    "account": "42trU9A5...",
    "signature": "5J3mBbAH...",
    "timestamp": 1716200000000,
    "symbol": "SOL",
    "amount": "1.00000000",
}

response = requests.post(
    "/api/v1/account/spot_asset/withdraw",
    json=payload,
    headers={"Accept": "*/*"},
)

data = response.json()