Skip to main content

Get Transferable Amount (Trading account)

Query the available amount to transfer of a specific coin in the Unified wallet.

HTTP Request​

GET /cloud/trade/v3/account/withdrawal

Request Parameters​

ParameterRequiredTypeComments
coinNametruestringCoin name, uppercase only. Supports up to 20 coins per request, use comma to separate. BTC,USDC,USDT,SOL

Response Parameters​

ParameterTypeComments
availableWithdrawalstringTransferable amount for the 1st coin in the request
availableWithdrawalMapObjectTransferable amount map for each requested coin. In the map, key is the requested coin, and value is the accordingly amount(string)
e.g., "availableWithdrawalMap":{"BTC":"4.54549050","SOL":"33.16713007","XRP":"10805.54548970","ETH":"17.76451865"}

Request Example​

GET /cloud/trade/v3/account/withdrawal?coinName=BTC,SOL,ETH,XRP HTTP/1.1
Host: openapi-testnet.zoomex.com
X-BAPI-SIGN: XXXXXX
X-BAPI-API-KEY: xxxxxxxxxxxxxxxxxx
X-BAPI-TIMESTAMP: 1739861239242
X-BAPI-RECV-WINDOW: 5000
Content-Type: application/json


Response Example​

{
"retCode": 0,
"retMsg": "OK",
"result": {
"availableWithdrawal": "4.54549050",
"availableWithdrawalMap": {
"BTC": "4.54549050",
"SOL": "33.16713007",
"XRP": "10805.54548970",
"ETH": "17.76451865"
}
},
"retExtInfo": {},
"time": 1739858984601
}