创建虚拟子账户

限速规则 5次/1s (UID)

描述

该接口目前支持批量创建虚拟子账户

HTTP请求

• POST /api/v2/user/create-virtual-subaccount

请求示例

curl -X POST "https://api.bitget.com/api/v2/user/create-virtual-subaccount" \
   -H "ACCESS-KEY:*******" \
   -H "ACCESS-SIGN:*" \
   -H "ACCESS-PASSPHRASE:*" \
   -H "ACCESS-TIMESTAMP:1659076670000" \
   -H "locale:en-US" \
   -H "Content-Type: application/json" \  
   -d '{"subAccountList": ["testtest"]}'

请求参数

参数名	参数类型	是否必须	描述
subAccountList	List<String>	是	虚拟昵称 长度必须为8位的纯英文字母组合 全局唯一

返回示例

{
    "code": "00000",
    "msg": "success",
    "requestTime": 1682660169412,
    "data": {
        "failureList": [
            {
                "subaAccountName": "****@*****.com"
            }
        ],
        "successList": [
            {
                "subaAccountUid": "***********",
                "subaAccountName": "****@*****.com",
                "status": "normal",
                "label": "",
                "permList": [
                    "contract_trade",
                    "spot_trade"
                ],
                "cTime": "1682660169573",
                "uTime": "1682660169573"
            }
        ]
    }
}

返回参数

返回字段	参数类型	字段说明
failureList	Array	创建失败子账户数组 - 账户昵称存在重复 - 创建子账户创建数量达到限制
subaAccountName	String	子账户名称
successList	Array	创建成功子账户数组
subaAccountUid	String	子账户uid
subaAccountName	String	子账户名称
status	String	子账户状态 normal 正常 freeze 冻结 del删除
permList	List	子账户权限 spot_trade 现货交易 contract_trade 合约交易读写 read read读取权限 子账户默认权限为spot_trade& contract_trade
label	String	备注
cTime	String	子账户创建时间，Unix毫秒时间戳
uTime	String	子账户更新时间，Unix毫秒时间戳