HTX is going to allow parent user to set tradable market(s) or asset transfer permission for sub users through new API endpoints
- API Announcements
Dear users,
HTX is going to allow parent user to set tradable market(s) for sub users through a new API endpoint - POST /v2/sub-user/tradable-market;
HTX is also going to allow parent user to set asset transfer permission for sub users through a new API endpoint - POST /v2/sub-user/transferability.
Effective Date: May 29, 2020 (GMT+8)
All the changes will be updated on https://huobiapi.github.io/docs/spot/v1/en/
HTX
May 29, 2020
1) POST /v2/sub-user/tradable-market
Via this endpoint, a parent user should be able to activate or deactivate the sub user’s trading permission in isolated margin market and cross margin market. The sub user’s trading permission in futures market should not be configurable via this endpoint for now. By default, sub user’s trading permission in spot market is activated.
Request Parameters
| Field Name | Data Type | Mandatory | Default Value | Description | Possible Value |
| subUids | integer | TRUE | Sub user’s UID list (multiple input is allowed, supporting maximum 50 UIDs, separated by comma) | ||
| accountType | string | TRUE | Account type | isolated-margin,cross-margin | |
| activation | string | TRUE | Account status | activated,deactivated |
Response
| Field Name | Data Type | Mandatory | Default Value | Description | Possible Value |
| code | integer | TRUE | Status code | ||
| message | string | FALSE | Error message (if any) | ||
| data | object | TRUE | |||
| { accountType | string | TRUE | Account type | isolated-margin,cross-margin | |
| activation | string | TRUE | Account status | activated,deactivated | |
| subUid | integer | TRUE | Sub user’s UID | ||
| errCode | integer | FALSE | Error code for rejection (only valid for rejected request) | ||
| errMessage } | string | FALSE | Error message for rejection (only valid for rejected request) |
2) POST /v2/sub-user/transferability
Via this endpoint, a parent user should be able to set asset transfer permission for sub user, i.e. to transfer asset from spot account to another sub user’s spot account who is under same parent user. By default, the asset transfer from sub user’s spot account to parent user’s spot account is allowed.
Request Parameters
| Field Name | Data Type | Mandatory | Default Value | Description | Possible Value |
| accountType | string | FALSE | spot | Account type | spot |
| transferrable | boolean | TRUE | Asset transfer permission | true,false | |
| subUids | integer | TRUE | Sub user’s UID list (multiple input is allowed, supporting maximum 50 UIDs, separated by comma) |
Response
| Field Name | Data Type | Mandatory | Description | Possible Value |
| code | integer | TRUE | Status code | |
| message | string | FALSE | Error message (if any) | |
| data | object | TRUE | ||
| { accountType | string | TRUE | Account type | spot |
| transferrable | boolean | TRUE | Asset transfer permission | true,false |
| subUid | string | TRUE | Sub user’s UID | |
| errCode | integer | FALSE | Error code for rejection (only valid for rejected request) | |
| errMessage } | string | FALSE | Error message for rejection (only valid for rejected request) |
API users should evaluate the business impact caused by the new feature, further to make relevant change in client’s application, if needed.
All the changes will be updated on HTX API Docs on the effective date.
