Place Order

• Rate limit: 10 requests/second/UID
• Rate limit: 1 request/second/UID for copy trading traders

Description

• Ignore the tradeSide parameter when position mode is in one-way-mode
• In “hedge-mode”, when there is limit close order occupying the position, if the size of next market close order and limit close orders exceeds the position size, it will return an “insufficient position error” instead of cancelling the current limit order and executing the market order

HTTP Request

• POST /api/v2/mix/order/place-order

Request Example

curl -X POST "https://api.cointr.com/api/v2/mix/order/place-order" \
  -H "ACCESS-KEY:your apiKey" \
  -H "ACCESS-SIGN:*" \
  -H "ACCESS-PASSPHRASE:*" \
  -H "ACCESS-TIMESTAMP:1659076670000" \
  -H "locale:zh-CN" \
  -H "Content-Type: application/json" \
  -d '{ "symbol": "ETHUSDT", "productType": "usdt-futures", "marginMode": "isolated", "marginCoin": "USDT", "size": "0.1", "price": "2000", "side": "sell", "tradeSide": "open", "orderType": "limit", "force": "gtc", "clientOid": "121211212122" }'

Request Parameters

Parameter	Type	Required	Description
symbol	String	Yes	Trading pair, e.g. ETHUSDT
productType	String	Yes	Product type USDT-FUTURES USDT professional futures COIN-FUTURES Mixed futures USDC-FUTURES USDC professional futures SUSDT-FUTURES USDT professional futures demo SCOIN-FUTURES Mixed futures demo SUSDC-FUTURES USDC professional futures demo
marginMode	String	Yes	Position mode isolated: isolated margin crossed: crossed margin
marginCoin	String	Yes	Margin coin(capitalized)
size	String	Yes	Amount (base coin)
price	String	No	Price of the order. Required if the order type is limit
side	String	Yes	Order direction buy: Buy sell: Sell
tradeSide	String	No	Direction Only required in hedge-mode Open and Close Notes: For open long, side fill in"buy"; tradeSide should be "Open" For open short, side fill in "sell"; tradeSide should be "open" For close long, side fill in "buy"; tradeSide should be "close" For close short, side fill in "sell";tradeSide should be "close"
orderType	String	Yes	Order type limit: limit orders market: market orders
force	String	No	Order expiration date. Required if the orderType is limit, default value is gtc ioc: Immediate or cancel fok: Fill or kill gtc: Good till canceled post_only: Post only
clientOid	String	No	Customize order ID,The idempotency time is 20 minutes
reduceOnly	String	No	Whether or not to just reduce the position: YES, NO Default: NO. Applicable only in one-way-position mode
presetStopSurplusPrice	String	No	Take-profit value No take-profit is set if the field is empty.
presetStopLossPrice	String	No	Stop-loss value No stop-loss is set if the field is empty.
stpMode	String	No	STP Mode, default none none not setting STP cancel_taker cancel taker order cancel_maker cancel maker order cancel_both cancel both of taker and maker orders

Response Example

{
    "code": "00000",
    "msg": "success",
    "requestTime": 1695806875837,
    "data": {
        "clientOid": "121211212122",
        "orderId": "121211212122"
    }
}

Response Parameters

Parameter	Type	Description
orderId	String	Order ID
clientOid	String	Customize order ID