Skip to main content

Create Virtual Subaccount

Frequency limit: 5 times/1s (User ID)

Description

This interface currently supports the creation of virtual sub-accounts in batch.

HTTP request

  • POST /api/v2/user/create-virtual-subaccount
Request Example
curl -X POST "https://api.bitget.com/api/v2/user/create-virtual-subaccount" \  -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 \'{"subAccountList": ["bitgeton"]}'

Request parameters

ParameterTypeRequiredDescription
subAccountListList<String>YesVirtual alias8-character English lettersGlobal unique
Response Example
{
"code": "00000",
"msg": "success",
"requestTime": 1682660169412,
"data": {
"failureList": [
{
"subaAccountName": "guningfh@virtual-bitget.com"
}
],
"successList": [
{
"subaAccountUid": "9837924274",
"subaAccountName": "guningfk@virtual-bitget.com",
"status": "normal",
"label": "",
"permList": [
"contract_trade",
"spot_trade"
],
"cTime": "1682660169573",
"uTime": "1682660169573"
}
]
}
}

Response Parameters

ParameterTypeDescription
failureListArraySub-account array creation failed
- Alias already exists
- The number of sub-accounts created has reached the limit
subaAccountNameStringSub-account name
successListArraySub-account array created successfully
subaAccountUidStringSub-account uid
subaAccountNameStringSub-account name
statusStringSub-account status
normal Normal
freeze Freeze
del Deleted
permListListSub-account permissions
transfer Transfer
deposit Deposit
withdraw Withdraw
spot_trade Spot trade
contract_trade Futures trade read-write
readonly read Read permissions
The default permissions for sub-accounts are spot_trade & contract_trade
labelStringNote
cTimeStringSub-account creation time, Unix millisecond timestamps.
uTimeStringSub-account update time, Unix millisecond timestamps.