Orders

Place Margin Order

{
  "orderId": "5bd6e9286d99522a52e458de",
  "borrowSize": 10.2,
  "loanApplyId": "600656d9a33ac90009de4f6f"
}

There are two types of orders: (limit) order: set price and quantity for the transaction. (market) order : set amount or quantity for the transaction.

Before placing an order, make sure there are enough funds in your Margin Account. Once the order is successfully placed, the amount of funds required for the order will be frozen. The Holds will depend on the type of order placed as well as the request parameters set.

TIP

Placing an order will enable price protection. When the price of the limit order is outside the threshold range, the price protection mechanism will be triggered, causing the order to fail.

Please note that once your order enters the order book, the system will freeze the Order handling fee for the order ahead of time.

Before placing orders, please be sure to fully understand the meaning of the parameters for each symbol.

Do not include extra spaces in JSON strings.

Place Order Limit

The maximum active orders for a single trading pair in one account is 200 (stop orders included).

HTTP REQUEST

POST /api/v1/margin/order

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, such as, ETH-BTC
type String No Order type limit and market, The default is limit
stp String No self trade prevention is divided into four strategies: CN, CO, CB , and DC
marginModel String No The type of trading, including cross (cross mode) and isolated (isolated mode). It is set at cross by default.
autoBorrow boolean No Auto-borrow to place order. The system will first borrow you funds at the optimal interest rate and then place an order for you. Currently autoBorrow parameter only supports cross mode, not isolated mode. When add this param, stop profit and stop loss are not supported, if it is a sell order, the size must be passed
autoRepay boolean No Automatically repay when placing an order, that is, the system automatically triggers repayment after the order is completed. The maximum currency repayment amount is the trade amount. The same order does not support the simultaneous use of autoBorrow and autoRepay.
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)
  • When placing a market order, the size or funds must be set. For market buy orders, the funds must be set.
RESPONSES
Param Description
orderId 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.
Terms
MarginMode

There are two modes for API margin trading: cross and isolated, it is set at cross by default.

AutoBorrow

This is the symbol of Auto-Borrow, if it is set to true, the system will automatically borrow the funds required for an order according to the order amount. By default, the symbol is set to false. When your order amount is too large, exceeding the max. borrowing amount via the max. leverage or the risk limit of margin, then you will fail in borrowing and order placing. Currently autoBorrow parameter only supports cross mode, not isolated mode

There may be situations where the borrow is successful but the order placement fails. In this case, you can directly place the order again without the auto-borrow parameter, or choose the repayment operation.