关于API新增接口支持母用户设置子用户交易及划转权限的公告

尊敬的用户:

火币Global 将允许母用户通过以下新增API接口设置子用户的交易权限及划转权限 –
1) 母用户设置子用户的交易权限 – POST /v2/sub-user/tradable-market
2) 母用户设置子用户的划转权限 – POST /v2/sub-user/transferability

生效日期:2020年5月29日(GMT+8)

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

火币全球站
2020年5月29日

 

自本通知生效之日起,火币Global 将新增以下API接口 –

1) POST /v2/sub-user/tradable-market
通过此接口,母用户可以激活/解除子用户的逐仓杠杆及全仓杠杆交易权限。
注:
- 暂不支持通过此接口设置子用户的合约交易权限;
- 子用户的现货交易权限默认开通无须设置。

请求参数

名称类型是否必需默认值描述有效值
subUidsintegerTRUE 子用户UID列表(用于查询子用户状态,支持多填,最多50个,逗号分隔) 
accountTypestringTRUE 账户类型isolated-margin,cross-margin
activationstringTRUE 账户激活状态activated,deactivated

返回数据

名称类型是否必需默认值描述有效值
codeintegerTRUE 状态码 
messagestringFALSE 错误描述(如有) 
dataobjectTRUE   
{ accountTypestringTRUE 账户类型isolated-margin,cross-margin
activationstringTRUE 账户激活状态activated,deactivated
subUidintegerTRUE 子用户UID 
errCodeintegerFALSE 请求被拒错误码(仅在设置该subUid市场准入权限错误时返回) 
errMessage }stringFALSE 请求被拒错误消息(仅在设置该subUid市场准入权限错误时返回) 

2) POST /v2/sub-user/transferability
通过此接口,母用户可以设置子用户的资金转出(至同一母用户下另一子用户账户)的权限。
注:
子用户的资金转出权限包括:
- 由子用户现货(spot)账户转出至同一母用户下另一子用户的现货(spot)账户;
- 由子用户现货(spot)账户转出至母用户现货(spot)账户(无须设置,默认开通)。

请求参数

名称类型是否必需默认值描述有效值
accountTypestringFALSEspot账户类型spot
transferrablebooleanTRUE 可划转权限true,false
subUidsintegerTRUE 子用户编号列表(可多填,以逗号分隔) 

返回数据

名称类型是否必需描述有效值
codeintegerTRUE状态码 
messagestringFALSE错误描述(如有) 
dataobjectTRUE  
{ accountTypestringTRUE账户类型spot
transferrablebooleanTRUE可划转权限true,false
subUidstringTRUE子用户编号 
errCodeintegerFALSE请求被拒错误码(仅在设置该subUid划转权限错误时返回) 
errMessage }stringFALSE请求被拒错误消息(仅在设置该subUid划转权限错误时返回) 

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

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