关于API新增接口支持母用户设置子用户交易及划转权限的公告
2020/05/29 14:35
- 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
通过此接口，母用户可以激活/解除子用户的逐仓杠杆及全仓杠杆交易权限。
注：
- 暂不支持通过此接口设置子用户的合约交易权限；
- 子用户的现货交易权限默认开通无须设置。
请求参数
| 名称 | 类型 | 是否必需 | 默认值 | 描述 | 有效值 |
| 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用户需自行评估以上新增接口对用户自身业务的适配，必要时更新相关应用。
所有变更将自本通知生效之日起更新至 HTX API Docs。
客服邮箱 [email protected]
