查询子账户列表

描述

查询虚拟子账户列表

HTTP请求

• GET /api/v3/user/sub-list
• 限频规则: 10次/s/UID
• 需要统一账户管理读取权限
• 仅母账户才能调用此接口

请求示例

curl -X GET "https://api.bitget.com/api/v3/user/sub-list?limit=100&cursor=18484" \
   -H "ACCESS-KEY:*******" \
   -H "ACCESS-SIGN:*" \
   -H "ACCESS-PASSPHRASE:*" \
   -H "ACCESS-TIMESTAMP:1659076670000" \
   -H "locale:en-US" \
   -H "Content-Type: application/json"

请求参数

参数名	参数类型	是否必须	描述
limit	String	否	每页条目数 默认值为100，最大值为100
cursor	String	否	游标ID 用于翻页，首次查询不传，查询第二页及后面的数据时，取上一次查询返回的cursor

返回示例

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1740212430491,
  "data": {
    "list": [
      {
        "subUid": "xxx",
        "username": "llt****@virtual-bitget.com",
        "status": "normal",
        "accountMode": "CLASSIC",
        "type": "VIRTUAL_CHILD",
        "note": "xxxx",
        "createdTime": "1740129303268",
        "updatedTime": "1740129303268"
      },
      {
        "subUid": "xxx",
        "username": "zml****@virtual-bitget.com",
        "status": "normal",
        "accountMode": "UNIFIED",
        "type": "VIRTUAL_CHILD",
        "note": "xxx",
        "createdTime": "1740211445018",
        "updatedTime": "1740211445018"
      },
      {
        "subUid": "xxx",
        "username": "tmr****@virtual-bitget.com",
        "status": "freeze",
        "accountMode": "UNIFIED",
        "type": "VIRTUAL_CHILD",
        "note": "xxx",
        "createdTime": "1740131800692",
        "updatedTime": "1740212129476"
      }
    ],
    "hasNext": false,
    "cursor": "18484"
  }
}

返回参数

返回字段	参数类型	字段说明
cursor	String	游标ID
hasNext	String	是否还有下一页数据
list	Array	子账户列表
> username	String	虚拟邮箱地址
> subUid	String	虚拟子账户ID
> status	String	账户状态 normal 正常 frozen 冻结
> accountMode	String	账户模式 CLASSIC 经典账户模式 UNIFIED 统一账户模式
> type	String	账户类型 COMMON 普通子账号 BROKER_CHILD broker子账号 VIRTUAL_CHILD 虚拟子账号 VIRTUAL_STRATEGY_CHILD 策略虚拟子账号 COPPER_CHILD cooper子账号账号 CONTRACT_EXPERIENCE 合约体验金帐号 ENTRUST_CHILD 托管子账户 TRADE_PRO trade Pro账户 VIRTUAL_TRACE_CHILD 合约跟单虚拟子账号 CONTRACT_TRADER_CHILD 合约交易员虚拟子账户 DEMO_ACCOUNT 演示账户 TRADE_PRO_DEMO_ACCOUNT Trade演示账户 STRATEGY_DEMO_ACCOUNT 策略DEMO演示账户 PAP_TRADING_ACCOUNT 模拟盘账户
> note	String	备注
> createdTime	String	子账户创建时间,Unix毫秒时间戳
> updatedTime	String	子账户修改时间,Unix毫秒时间戳