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

火币 2020-5-29 14:35

尊敬的用户：

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

生效日期：2020年5月29日（GMT+8）

具体变更细节及参数要求，请参考API文档：

火币全球站
2020年5月29日

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

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

请求参数

名称	类型	是否必需	默认值	描述	有效值
subUids	integer	TRUE		子用户UID列表（用于查询子用户状态，支持多填，最多50个，逗号分隔）
accountType	string	TRUE		账户类型	isolated-margin,cross-margin
activation	string	TRUE		账户激活状态	activated,deactivated

返回数据

名称	类型	是否必需	默认值	描述	有效值
code	integer	TRUE		状态码
message	string	FALSE		错误描述（如有）
data	object	TRUE
{ accountType	string	TRUE		账户类型	isolated-margin,cross-margin
activation	string	TRUE		账户激活状态	activated,deactivated
subUid	integer	TRUE		子用户UID
errCode	integer	FALSE		请求被拒错误码（仅在设置该subUid市场准入权限错误时返回）
errMessage }	string	FALSE		请求被拒错误消息（仅在设置该subUid市场准入权限错误时返回）

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

请求参数

名称	类型	是否必需	默认值	描述	有效值
accountType	string	FALSE	spot	账户类型	spot
transferrable	boolean	TRUE		可划转权限	true,false
subUids	integer	TRUE		子用户编号列表（可多填，以逗号分隔）

返回数据

名称	类型	是否必需	描述	有效值
code	integer	TRUE	状态码
message	string	FALSE	错误描述（如有）
data	object	TRUE
{ accountType	string	TRUE	账户类型	spot
transferrable	boolean	TRUE	可划转权限	true,false
subUid	string	TRUE	子用户编号
errCode	integer	FALSE	请求被拒错误码（仅在设置该subUid划转权限错误时返回）
errMessage }	string	FALSE	请求被拒错误消息（仅在设置该subUid划转权限错误时返回）

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

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

Scan QR code with WeChat

Link: 火币

Tags: 重要公告