Sub Transfer
Frequency limit:10 times/1s (User ID)
Description
The types of transfers supported by this interface include- Parent account rotor account (only parent account APIKey has access)- Sub-account to parent account (only parent account APIKey has access)- Sub-account rotor accounts (only the parent account APIKey has access and requires that the payee sub-accounts are the same parent account)The UIDs of the incoming and outgoing accounts in the request parameters must be mother-son/brother relationships, and only the mother account has access to all transfer operations.
HTTP request
- POST /api/v2/spot/wallet/subaccount-transfer
Request Example
curl -X POST "https://api.bitget.com/api/v2/spot/wallet/transfer" \ -H "ACCESS-KEY:you apiKey" \ -H "ACCESS-SIGN:*" \ -H "ACCESS-PASSPHRASE:*" \ -H "ACCESS-TIMESTAMP:1659076670000" \ -H "locale:en-US" \ -H "Content-Type: application/json" \ -d \'{"fromType": "spot","toType": "usdt_futures","amount": "100","coin": "USDT"}'
Request Parameter
Parameter | Type | Required | Description |
---|---|---|---|
fromType | String | Yes | Type of account to be transferred |
toType | String | Yes | Recipient account type |
amount | String | Yes | Amount to transfer |
coin | String | Yes | Currency of transfer |
symbol | String | No | Required when transferring to or from an account type that is a leveraged position-by-position account. |
clientOid | String | No | Custom order ID |
fromUserId | String | Yes | Outgoing Account UID |
toUserId | String | Yes | Incoming Account UID |
Response Example
{
"code": "00000",
"msg": "success",
"data": {
"transferId": "123456",
"clientOid": "x123"
}
}
Response Parameter
Parameter | Type | Description |
---|---|---|
transferId | String | Transfer ID |
clientOid | String | Custom order ID |