关于API新增母用户获取子用户列表及其账户信息接口的公告

尊敬的用户:

自本通知生效之日起,火币Global将新增以下REST API节点 -

GET /v2/sub-user/user-list       获取所有子用户的UID列表及各用户状态

GET /v2/sub-user/user-state    获取特定子用户的用户状态

GET /v2/sub-user/account-list 获取特定子用户的账户列表及账户状态

 

生效日期:2020年6月16日(GMT+8)

具体变更细节及参数要求,请参考API文档:https://huobiapi.github.io/docs/spot/v1/cn/

火币全球站
2020年6月16日

 

GET /v2/sub-user/user-list

获取所有子用户的UID列表及各用户状态

API Key权限:读取

请求参数

参数名称 数据类型 是否必需 描述
fromId long FALSE 查询起始编号(仅对翻页查询有效)

返回数据

名称 类型 是否必需 描述 有效值
code integer TRUE 状态码  
message string FALSE 错误描述(如有)  
data object TRUE 按子用户uid正序排列,每次最多返回100个uid  
{ uid integer TRUE 子用户编号  
userState } string TRUE 子用户状态 枚举lock,normal
nextId integer FALSE 下页查询起始编号(仅在存在下页数据时返回)  

示例

 

{

    "code": 200,

    "data": [

        {

            "uid": 63628520,

            "userState": "normal"

        },

        {

            "uid": 132208121,

            "userState": "normal"

        }

    ]

}

 

GET /v2/sub-user/user-state

获取特定子用户的用户状态

API Key权限:读取

请求参数

参数名称 数据类型 是否必需 描述
subUid long TRUE 子用户UID

返回数据

名称 类型 是否必需 备注 有效值
code integer TRUE 状态码  
message string FALSE 错误描述(如有)  
data object TRUE    
{ uid integer TRUE 子用户编号  
userState } string TRUE 子用户状态 枚举: lock,normal

示例

 

{

    "code": 200,

    "data": {

        "uid": 132208121,

        "userState": "normal"

    }

}

 

GET /v2/sub-user/account-list

获取特定子用户的账户列表及账户状态

 

API Key权限:读取

 

请求参数

参数名称 数据类型 是否必需 描述
subUid long TRUE 子用户UID

返回数据

名称 类型 是否必需 描述 有效值
code integer TRUE 状态码  
message string TRUE 错误描述(如有)  
data object TRUE    
{ accountType string TRUE 账户类型 枚举: spot,isolated-margin,cross-margin,futures,swap
activation string TRUE 账户激活状态 枚举: activated,deactivated
transferrable bool FALSE 可划转权限(仅对accountType=spot有效) 枚举: true,false
accountIds object FALSE    
{ accountId string TRUE 账户编号  
subType string FALSE 账户子类型(仅对逐仓杠杆账户有效)  
accountStatus } string TRUE 账户状态 normal,locked
Uid } long TRUE 子用户编号  

示例

 

{

    "code": 200,

    "data": {

        "uid": 132208121,

        "list": [

            {

                "accountType": "isolated-margin",

                "activation": "activated"

            },

            {

                "accountType": "cross-margin",

                "activation": "deactivated"

            },

            {

                "accountType": "spot",

                "activation": "activated",

                "transferrable": true,

                "accountIds": [

                    {

                        "accountId": 12255180,

                        "accountStatus": "normal"

                    }

                ]

            }

        ]

    }

}

 

API用户需自行评估以上新接口上线对用户自身业务的适配,必要时更新相关应用。

所有变更将自本通知生效之日起更新至 HTX API Docs