Margin HF Trade

Place HF order

This interface is used to place cross-margin or isolated-margin high-frequency margin trading

HTTP REQUEST

POST /api/v3/hf/margin/order

Example

POST /api/v3/hf/margin/order

{
    "clientOid": "235b7471-0190-4e10-a4cf-953c83a06af5",
    "side": "sell",
    "symbol": "ETH-USDT",
    "type": "market",
    "isIsolated": false,
    "funds": "1"
}

{
    "success": true,
    "code": "200000",
    "data": {
      "orderId": "5bd6e9286d99522a52e458de",
      "borrowSize":10.2,
      "loanApplyId":"600656d9a33ac90009de4f6f"
    }
  }
}

API KEY PERMISSIONS

This endpoint requires the Margin Trading permission.

REQUEST URL

This endpoint support Spot URL

REQUEST RATE LIMIT

Spot weight：5

PARAMETERS

Public order placement request parameters

Param	Type	Mandatory	Description
clientOid	String	Yes	Client Order Id，unique identifier created by the user, the use of UUID is recommended
side	String	Yes	buy or sell
symbol	String	Yes	symbol
type	String	No	Order type limit and market, defult is limit
stp	String	No	self trade prevention is divided into four strategies: CN, CO, CB , and DC
isIsolated	boolean	No	true-isolated margin ,false-cross margin. defult as false
autoBorrow	boolean	No	When Margin HFTrading Account has inefficient balance, our system autoborrows inefficient assets and opens positions according to the lowest market interest rate.
autoRepay	boolean	No	AutoPay allows returning borrowed assets when you close a position. Our system automatically triggers the repayment and the maximum repayment amount equals to the filled-order amount.

Additional Request Parameters Required by limit Orders

Param	Type	Mandatory	Description
price	String	Yes	Specify price for currency
size	String	Yes	Specify quantity for currency
timeInForce	String	No	Order timing strategy GTC, GTT, IOC, FOK (The default is GTC)
cancelAfter	long	No	Cancel after n seconds，the order timing strategy is GTT
postOnly	boolean	No	passive order labels, this is disabled when the order timing strategy is IOC or FOK
hidden	boolean	No	Hidden or not (not shown in order book)
iceberg	boolean	No	Whether or not only visible portions of orders are shown in iceberg orders
visibleSize	String	No	Maximum visible quantity in iceberg orders

Additional request parameters required by market orders

Param	Type	Mandatory	Description
size	String	No	(Select one out of two: size or funds)
funds	String	No	(Select one out of two: size or funds)

RESPONSES

Param	Description
orderNo	An order Id is returned once an order is successfully placed.
borrowSize	Borrowed amount. The field is returned only after placing the order under the mode of Auto-Borrow.
loanApplyId	ID of the borrowing response. The field is returned only after placing the order under the mode of Auto-Borrow.