查询子账户列表

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

描述

查询子账户列表

HTTP请求

• GET /api/v2/user/virtual-subaccount-list

请求示例

curl "https://api.bitget.com/api/v2/user/virtual-subaccount-list?limit=20" \
   -H "ACCESS-KEY:*******" \
   -H "ACCESS-SIGN:*" \
   -H "ACCESS-PASSPHRASE:*" \
   -H "ACCESS-TIMESTAMP:1659076670000" \
   -H "locale:en-US" \
   -H "Content-Type: application/json"

请求参数

参数名	参数类型	是否必须	描述
status	String	否	子账户状态 normal freeze del
limit	String	否	默认20 最大100
idLessThan	String	否	最后一条记录的ID

返回示例

{
    "code": "00000",
    "msg": "success",
    "requestTime": 1656589586807,
    "data": {
        "endId": 51,
        "subAccountList": [
            {
                "subAccountUid": "7713789662",
                "subAccountName": "mySub01@bgbroker6314497154",
                "status": "normal",
                "permList": [
                    "readonly",
                    "spot_trade",
                    "contract_trade"
                ],
                "label": "mySub01",
                "cTime": "1653287983475",
                "uTime": "1682660169573"
            }
        ]
    }
}

返回参数

返回字段	参数类型	字段说明
subAccountList	Array	子账户列表
> subAccountUid	String	虚拟子账户Uid
> subAccountName	String	虚拟子账户昵称 长度为8位的英文字母
> label	String	子账户备注 长度为20位
> status	String	子账户状态
> permList	List	子账户apiKey 权限 contract_order 合约订单 contract_position 合约持仓 spot_trade 现货交易 margin_trade 现货杠杆交易 copytrading_trade 跟单交易 wallet_transfer 钱包划转 wallet_withdraw 钱包提币 选择只读权限类型时传入钱包提币无效，提币没有只读权限
> cTime	String	创建时间
> uTime	String	最新修改时间
endId	String	查询数据返回最小ID