Dear API users,

HTX is currently allowing sub user to trade in spot market, but not in margin mode. Since the effective day of this notification, authorized sub users are allowed to trade in margin mode, through related existing REST API endpoints.

Effective Date: September 16, 2019 (GMT+8)
All the changes will be updated on 【API Docs】

HTX
September 12, 2019

The following are change details:
1） POST /v1/dw/transfer-in/margin
Transfer asset from sub user’s spot account to margin account.
2） POST /v1/dw/transfer-out/margin
Transfer asset from sub user’s margin account to spot account.
3） POST /v1/margin/orders
Apply a margin loan by sub user.
4） POST /v1/margin/orders/{order-id}/repay
Repay margin loan by sub user.
5） GET /v1/margin/loan-orders
Query margin loan orders by sub user.
6） GET /v1/margin/accounts/balance
Query margin account balance by sub user.

Asset transfer between parent user’s spot account and sub user’s spot account is still going through existing endpoint “POST /v1/subuser/transfer”. Asset transfer between parent user’s margin account and sub user’s margin account will not be supported.

Currently parent user is able to query aggregated spot account balance from all sub users through existing endpoint “GET /v1/subuser/aggregate-balance”. Since the effective day of this notification, this endpoint will be supporting aggregated margin account balance from all sub users as well. A new enumerated value “margin” will be added into existing field “type” in response message, in order to differentiate the aggregated balance which is coming from spot account or margin account. (margin account balance = user’s equity – unpaid principal – unpaid interest)

Currently parent user is able to query individual’s spot account balance from specific sub user through existing endpoint “GET /v1/account/accounts/{sub-uid}”. Since the effective day of this notification, this endpoint will be supporting individual’s margin account balance as well. A new field “symbol” will be added into response message, in order to differentiate margin accounts of the sub user.

Currently both parent user and sub user are able to query their own loan orders through existing endpoint “GET /v1/margin/loan-orders”. Since the effective day of this notification, by adding a new optional field “sub-uid” in the request, parent user will be allowed to query loan orders of a specific sub user. If “sub-uid” is not specified, this endpoint will still return loan orders from current logged-in user.

Currently both parent user and sub user are able to query their own margin account balance through existing endpoint “GET /v1/margin/ accounts/balance”. Since the effective day of this notification, by adding a new optional field “sub-uid” in the request, parent user will be allowed to query margin account balance of a specific sub user. If “sub-uid” is not specified, this endpoint will still return margin account balance from current logged-in user.

Parent user is only able to authorize a sub user for margin trading from HTX official web. An authorized sub user will be able to trade all eligible symbols in margin mode, and share the credit quota with parent user.

1、REST API version 1 – Parent User to Query All Sub Users’ Aggregated Account Balance
GET /v1/subuser/aggregate-balance （API Key Permission: Read）
Request parameter(s):N/A

Response:

2、REST API version 1 – Parent User to Query Specific Sub User’s Account Balance
GET /v1/account/accounts/{sub-uid} （API Key Permission: Read）
Request parameter(s):N/A

Response:

3、REST API version 1 – Query Loan Orders
GET /v1/margin/loan-orders (API Key Permission: Read)

Request parameter(s):

Response:

4、REST API version 1 – Query Margin Account Balance
GET /v1/margin/accounts/balance (API Key Permission: Read)
Request parameter(s):

Response: