Announcement on the Adjustment of Sub-account Functions
11/01/2022, 21:10:11
Dear Users:
We have recently upgraded our sub-accounts system. Updates to our sub-account related features are described below:
1. The maximum number of sub-accounts available is determined based on the tier level of the master account, as described below:
| Master Account Tier (Fee Tier) | Maximum Number of Sub-Accounts |
| LV 0 | 5 |
| LV 1 | 5 |
| LV 2 | 5 |
| LV 3 | 5 |
| LV 4 | 10 |
| LV 5 | 15 |
| LV 6 | 20 |
| LV 7 | 25 |
| LV 8 | 30 |
| LV 9 | 35 |
| LV 10 | 40 |
| LV 11 | 45 |
| LV 12 | 50 |
2. A type must also be set for each sub-account. There are three sub-account types:
All (can be used for all transaction categories)
Futures (can be used for all transaction categories except margin trading)
Margin (can be used for all transaction categories except futures trading)
For example: sub-accounts whose type setting are set to “Futures” cannot be used for margin trading; whereas, sub-accounts whose type setting are set to “Margin” cannot be used for futures trading. Sub-accounts whose type setting are set to “All” have no category restrictions and can be used for all transaction categories.
Note: all sub-account types can be used for spot trading.
3. Based on the upgrades to our sub-account system, corresponding changes to our open API are as follows:
● 1.GET /api/v2/sub-accounts replaces GET /api/v1/sub-accounts for querying, if sub-account quantity is greater than 100
● 2.GET /api/v2/sub/user replaces GET /api/v1/sub/user for querying, if sub-account quantity is greater than 100
● 3.POST /api/v1/sub/user supports passing value to new field 'access', for adding access limitation
PARAMETERS
| Param | Type | Mandatory | Description |
| password | String | Yes | Password(7-24 characters, must contain letters and numbers, cannot only contain numbers or include special characters) |
| remarks | String | No | Remarks(1~24 characters) |
| access | String | No | Permission (This can only be set to "All", "Futures", or "Margin". "All": unrestricted; "Futures": cannot use margin features; "Margin": cannot use futures features.) |
| subName | String | Yes | Sub-account name(must contain 7-32 characters, at least one number and one letter. Cannot contain any spaces.) |
RESPONSES
| Field | Description |
| remarks | Remarks |
| subName | Sub-account name |
| uid | Sub-account UID |
| access | Permission |
Example return values:
{
"code": "200000",
"data": {
"uid": 9969082973,
"subName": "AAAAAAAAAA0007",
"remarks":"remark",
"access": "All"
}
}
● GET /api/v1/user-info, The return value will be returned to the sub-account activation status by business line
RESPONSES
| Field | Description |
| level | level |
| subQty | Number of sub-accounts |
| >>generalSubQty | General sub-account opened quantity |
| >>marginSubQty | Margin sub-account opened quantity |
| >>futuresSubQty | Futures sub-account opened quantity |
| maxSubQty | Max number of sub-accounts |
| >>maxDefaultSubQty | Max number of default open sub-accounts |
| >>maxGeneralSubQty | Max number of General sub-accounts |
| >>maxMarginSubQty | Max number of Margin sub-account |
| >>maxFuturesSubQty | Max number of Futures sub-account |
Example return values:
{
"code": "200000",
"data": {
"level": 0,
"subQuantity": 11,
"subQuantityByType": {
"generalSubQuantity": 9,
"marginSubQuantity": 1,
"futuresSubQuantity": 1
},
"maxSubQuantity": 35,
"maxSubQuantityByType": {
"maxDefaultSubQuantity": 5,
"maxGeneralSubQuantity": 10,
"maxMarginSubQuantity": 10,
"maxFuturesSubQuantity": 10
}
}
}
4. If you have reached the maximum number of allowed sub-accounts but have a reasonable reason for needing more, contact us at: newapi@kucoin.plus
We will reasonably adjust your maximum sub-account limit according to your needs.
Note: sub-account limits for existing users will not be affected.
Thanks for your support!
The KuCoin API Team
Find the Next Crypto Gem On KuCoin!