获取子账户列表

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

描述

获取子账户列表

HTTP请求

• GET /api/v2/broker/account/subaccount-list

请求示例

curl "https://api.bitget.com/api/v2/broker/account/subaccount-list" \
  -H "ACCESS-KEY:your apiKey" \
  -H "ACCESS-SIGN:*" \
  -H "ACCESS-PASSPHRASE:*" \
  -H "ACCESS-TIMESTAMP:1659076670000" \
  -H "locale:zh-CN" \
  -H "Content-Type: application/json"

请求参数

参数名	参数类型	是否必须	描述
limit	String	否	默认10 最大100
idLessThan	Long String	否	上次查询lastEndId，上次查询返回的最后一个subUid，最近创建的子账户优先返回
status	String	否	normal 正常 freeze 冻结 del 删除
startTime	String	否	开始时间
endTime	String	否	结束时间

返回示例

{
    "code": "00000",
    "msg": "success",
    "requestTime": 1695784474208,
    "data": {
        "hasNextPage": false,
        "idLessThan": 404,
        "subList": [
            {
                "subUid": "*******",
                "subaccountName": "****@*****.com",
                "status": "normal",
                "permList": [
                    "read",
                    "spot_trade",
                    "contract_trade",
                    "transfer",
                    "withdraw",
                    "deposit"
                ],
                "label": "old remark",
                "language":"en_US",
                "cTime": "1695784057280",
                "uTime": "1695784057280"
            }
        ]
    }
}

返回参数

返回字段	参数类型	字段说明
subList	List<Object>	子账户列表
subUid	String	子账户uid
subaccountName	String	subaccountName作为前缀生成的虚拟邮箱用户名
status	String	normal 正常 freeze 冻结 del 删除
permList	List<String>	withdraw 提币权限 transfer 划转 spot_trade 现货交易 contract_trade 合约交易 readonly 读权限 deposit 充值权限
label	String	备注名称
ctime	String	数据创建时间，毫秒时间戳
utime	String	数据更新时间，毫秒时间戳
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