Skip to main content

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

ParameterTypeRequired?Description
clientWithdrawIdStringNoUnique client withdrawal ID. Must be 16-32 characters and contain only uppercase or lowercase letters and numbers.
coinStringYesAsset code.
networkStringYesNetwork name. Must be supported for the specified asset with withdrawals enabled.
addressStringYesWithdrawal address.
addressTagStringNoMemo/Tag. Required for networks that require one.
amountStringYesWithdrawal amount. Must be a positive numeric string.
accountListString[]YesAccounts 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 nameTypeDescription
clientWithdrawIdStringUnique client withdrawal ID.

Response example

{
"clientWithdrawId": "jdlq18csgwyVckvqB5gqlDEajhpZhiHjFqD4psPY"
}