Create Sub UID
Create a new sub user id. Use master user's api key only.
tip
The API key must have one of the below permissions in order to call this endpoint..
- master API key: "Account Transfer", "Subaccount Transfer", "Withdrawal"
HTTP Request
POST /user/v3/private/create-sub-member
Request Parameters
Parameter | Required | Type | Comments |
---|---|---|---|
username | true | string | Give a username of the new sub user id.
|
password | false | string | Set the password for the new sub user id.
|
memberType | true | integer | 1 : normal sub account, 6 : custodial sub account |
switch | false | integer |
|
isUta | false | boolean |
|
note | false | string | Set a remark |
Response Parameters
Parameter | Type | Comments |
---|---|---|
uid | string | Sub user Id |
username | string | Give a username of the new sub user id.
|
memberType | integer | 1 : normal sub account, 6 : custodial sub account |
status | integer | The status of the user account
|
remark | string | The remark |
Request Example
POST /user/v3/private/create-sub-member HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: xxxxxxxxxxxx
X-BAPI-API-KEY: xxxxxxxxxxxx
X-BAPI-TIMESTAMP: 1671174837503
X-BAPI-RECV-WINDOW: 50000
Content-Type: application/json
Content-Length: 109
{
"username": "testsubaccount",
"memberType": 1,
"switch": 1,
"note": "testnet subaccount"
}
Response Example
{
"retCode": 0,
"retMsg": "OK",
"result": {
"uid": "111111111",
"username": "testsubaccount",
"memberType": 1,
"status": 1,
"remark": "testnet subaccount"
},
"retExtInfo": {},
"time": 1671174837668
}