Initiate an internal transfer
- POST
/api/v3/wallet/transfer
Weight(IP): 20
Transfers funds to another user UID. Requires TRANSFER permission.
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 | No | Network name. If omitted, the default network for the asset is used. |
| receiveUid | Long | Yes | Recipient UID. Cannot be the current user's UID. |
| amount | String | Yes | Transfer 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": "order-002",
"coin": "USDT",
"receiveUid": 1224231503,
"amount": "22",
"accountList": ["FUNDING", "SPOT", "UNIMARGIN"]
}
Response parameters
| Field name | Type | Description |
|---|---|---|
| clientWithdrawId | String | Unique client withdrawal ID. |
Response example
{
"clientWithdrawId": "lkjavoiqaNzqVr0AGj1uDYUpwl23lxjaw"
}