Initiate an on-chain withdrawal
- POST
/api/v3/wallet/withdraw
Weight(IP): 20
Submits an on-chain withdrawal. Requires WITHDRAW permission. Asset and network configurations are based on GET /api/v3/coins.
Request parameters
| Parameter | Type | Required? | Description |
|---|---|---|---|
| clientWithdrawId | String | No | Unique client withdrawal ID. Must be 16-32 characters and contain only uppercase or lowercase letters and numbers. |
| coin | String | Yes | Asset code. |
| network | String | Yes | Network name. Must be supported for the specified asset with withdrawals enabled. |
| address | String | Yes | Withdrawal address. |
| addressTag | String | No | Memo/Tag. Required for networks that require one. |
| amount | String | Yes | Withdrawal amount. Must be a positive numeric string. |
| accountList | String[] | Yes | Accounts to debit: UNIMARGIN (futures account), SPOT (spot account), or FUNDING (funding account). |
Request example
{
"clientWithdrawId": "",
"coin": "USDT",
"network": "BSC",
"address": "0x4a5EF3a85370d5b868BE1941Da2281f4F11755a1",
"addressTag": "",
"amount": "0.001",
"accountList": ["FUNDING", "SPOT", "UNIMARGIN"]
}
Response parameters
| Field name | Type | Description |
|---|---|---|
| clientWithdrawId | String | Unique client withdrawal ID. |
Response example
{
"clientWithdrawId": "jdlq18csgwyVckvqB5gqlDEajhpZhiHjFqD4psPY"
}