Skip to main content

Initiate an internal transfer

  • POST /api/v3/wallet/transfer

Weight(IP): 20

Transfers funds to another user UID. Requires TRANSFER permission.

Request parameters

ParameterTypeRequired?Description
clientWithdrawIdStringNoUnique client withdrawal ID. Must be 16-32 characters and contain only uppercase or lowercase letters and numbers.
coinStringYesAsset code.
networkStringNoNetwork name. If omitted, the default network for the asset is used.
receiveUidLongYesRecipient UID. Cannot be the current user's UID.
amountStringYesTransfer amount. Must be a positive numeric string.
accountListString[]YesAccounts to debit: UNIMARGIN (futures account), SPOT (spot account), or FUNDING (funding account).

Request example

{
"clientWithdrawId": "order-002",
"coin": "USDT",
"receiveUid": 1224231503,
"amount": "22",
"accountList": ["FUNDING", "SPOT", "UNIMARGIN"]
}

Response parameters

Field nameTypeDescription
clientWithdrawIdStringUnique client withdrawal ID.

Response example

{
"clientWithdrawId": "lkjavoiqaNzqVr0AGj1uDYUpwl23lxjaw"
}