获取经纪商子账户列表

描述

HTTP请求

• GET /api/v3/broker/sub-list
• 限频规则: 20次/秒/UID
• 仅用户类型为ND Broker的母账户才能调用该接口

请求示例

curl "https://api.bitget.com/api/v3/broker/sub-list" \
   -H "ACCESS-KEY:*******" \
   -H "ACCESS-SIGN:*" \
   -H "ACCESS-PASSPHRASE:*" \
   -H "ACCESS-TIMESTAMP:1659076670000" \
   -H "locale:en-US" \
   -H "Content-Type: application/json" 

请求参数

参数名	参数类型	是否必须	描述
limit	String	否	每页条目数 - 默认10 最大100
cursor	String	否	游标ID 用于分页。首次调用不传。后续调用传入上次查询返回的最后一个subUid
status	String	否	账户状态 normal 正常 freeze 冻结

返回示例

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1767149918448,
  "data": {
    "subList": [
      {
        "subUid": "12345678910",
        "subaccountName": "hun****@broker_8383826362",
        "subaccountEmail": null,
        "status": "normal",
        "permList": [
          "read",
          "uta_spot_trade",
          "uta_margin_trade",
          "uta_contract_trade",
          "transfer",
          "withdraw",
          "deposit"
        ],
        "label": "hunterusersub21523121",
        "language": "zh_CN",
        "cTime": "1767148977593",
        "uTime": "1767148977593"
      }
    ]
  }
}

返回参数

返回字段	参数类型	字段说明
subList	String	子账户列表
> subUid	String	子账户uid
>subaccountName	String	子账户用户名
>subaccountEmail	String	子账户邮箱
>status	String	子账户状态 normal 正常 freeze 冻结
>permList	String	权限列表 withdraw 提币 transfer 划转 spot_trade 现货交易 contract_trade 合约交易 margin_trade杠杆交易 deposit 充值权限
>label	String	备注
>ctime	String	账户创建时间 - Unix毫秒时间戳
>utime	String	账户更新时间 - Unix毫秒时间戳
>language	String	子账户语言 en_US zh_CN ja_JP vi_VN zh_TW ru_RU es_ES tr_TR fr_FR de_DE pt_PT th_TH