Skip to main content

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

ParameterTypeRequiredDescription
fromTypeStringYesType of account to be transferred
toTypeStringYesRecipient account type
amountStringYesAmount to transfer
coinStringYesCurrency of transfer
symbolStringNoRequired when transferring to or from an account type that is a leveraged position-by-position account.
clientOidStringNoCustom order ID
fromUserIdStringYesOutgoing Account UID
toUserIdStringYesIncoming Account UID
Response Example
{
"code": "00000",
"msg": "success",
"data": {
"transferId": "123456",
"clientOid": "x123"
}
}

Response Parameter

ParameterTypeDescription
transferIdStringTransfer ID
clientOidStringCustom order ID