Place Order

Response Example

{
  "success": true,
  "code": 0,
  "data": {
    "orderId": "739113577038255616",
    "ts": 1761888808839
  }
}

POST /api/v1/private/order/create

Required Permission: Order Placing

Request Parameters:

Parameter	Type	Required	Description
symbol	string	true	Contract
price	decimal	true	Price
vol	decimal	true	Quantity
leverage	int	false	Leverage, must be provided when opening a position
side	int	true	Order direction 1 open long, 2 close short, 3 open short, 4 close long
type	int	true	Order type,1: limit,2: Post Only (maker only),3: IOC,4: FOK,5: market
openType	int	true	Open type,1: isolated,2: cross
externalOid	string	false	External order id
positionId	int	false	Position id
stopLossPrice	decimal	false	Stop-loss price
takeProfitPrice	decimal	false	Take-profit price
lossTrend	int	false	Stop-loss price type;1: latest price (default);2: fair price;3: index price
profitTrend	int	false	Take-profit price type;1: latest price (default);2: fair price;3: index price
priceProtect	int	false	Conditional order trigger protection: "1","0", default "0" disabled. Required only for plan orders/TP-SL orders
positionMode	int	false	Position mode, default dual-side; 2: one-way; 1: dual-side
reduceOnly	boolean	false	Reduce-only, only applicable in one-way mode
marketCeiling	boolean	false	100% market open
flashClose	boolean	false	Flash close
bboTypeNum	int	false	Limit order type - BBO type; 0: not BBO;1: opposite-1;2: opposite-5;3: same-side-1;4: same-side-5;
stpMode	number	false	Self-trade prevention mode: 0 no action; 1 cancel both taker and maker orders; 2 cancel maker orders only; 3 cancel taker orders only

Response Parameters:

On success, success = true and data is an object containing orderId (string) and ts (Unix millisecond timestamp of the server response); on failure, success = false and data = null