新建子帳戶

創建新的子帳戶。需使用母帳戶的API key。

提示

在調用接口時，使用的API key至少需要擁有以下其中一種權限

• 母API key: "Account Transfer（資產帳戶劃轉）", "Subaccount Transfer（母子帳戶劃轉）", "Withdrawal（提幣）"

HTTP 請求

POST /v5/user/create-sub-member

請求參數

參數	是否必須	類型	說明
username	true	string	給新的子帳戶創建一個用戶名。 6-16位字符，須同時含有數字和字母。 不能與已存在或已刪除的帳戶用戶名重複。
password	false	string	給新的子帳戶設置一個密碼。 8-30位字符，須同時含有數字和大小寫字母。
memberType	true	integer	1: 普通子帳戶, 6: 託管子帳戶
switch	false	integer	0: 關閉快捷登陸 (默認關閉) 1: 打開快捷登陸.
isUta	false	boolean	廢棄, 總是創建UTA子帳戶
note	false	string	設置備註

返回參數

參數	類型	說明
uid	string	子帳戶userId
username	string	給新的子帳戶創建一個用戶名 6-16位字符，須同時含有數字和字母。 不能與已存在或已刪除的帳戶用戶名重複。
memberType	integer	1: 普通子帳戶, 6: 託管子帳戶
status	integer	帳戶狀態 1: 正常 2: 登陸封禁 4: 凍結
remark	string	設置的備註

請求示例

HTTP

POST /v5/user/create-sub-member HTTP/1.1
Host: api.bybit.com
X-BAPI-SIGN: XXXXXXX
X-BAPI-API-KEY: xxxxxxxxxxxxxxxxxx
X-BAPI-TIMESTAMP: 1676429344202
X-BAPI-RECV-WINDOW: 5000
Content-Type: application/json

{
    "username": "xxxxx",
    "memberType": 1,
    "switch": 1,
    "note": "test"
}

Python

from pybit.unified_trading import HTTP
session = HTTP(
    testnet=True,
    api_key="xxxxxxxxxxxxxxxxxx",
    api_secret="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
)
print(session.create_sub_uid(
    username="xxxxx",
    memberType=1,
    switch=1,
    note="test",
))

Node.js

const { RestClientV5 } = require('bybit-api');

const client = new RestClientV5({
  testnet: true,
  key: 'xxxxxxxxxxxxxxxxxx',
  secret: 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx',
});

client
  .createSubMember({
    username: 'xxxxx',
    memberType: 1,
    switch: 1,
    note: 'test',
  })
  .then((response) => {
    console.log(response);
  })
  .catch((error) => {
    console.error(error);
  });

響應示例

{
    "retCode": 0,
    "retMsg": "",
    "result": {
        "uid": "53888000",
        "username": "xxxxx",
        "memberType": 1,
        "status": 1,
        "remark": "test"
    },
    "retExtInfo": {},
    "time": 1676429344734
}