Announcement on the Adjustment of Sub-account Functions

Announcement on the Adjustment of Sub-account Functions

11/01/2022, 13: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!

Download KuCoin App >>>

Follow us on Twitter >>>

Join us on Telegram >>>

Join the KuCoin Global Communities >>>