Skip to main content

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

ParameterTypeRequiredDescription
symbolStringYesTrading pair, e.g. ETHUSDT
productTypeStringYesProduct 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
marginModeStringYesPosition mode
isolated: isolated margin
crossed: crossed margin
marginCoinStringYesMargin coin(capitalized)
sizeStringYesAmount (base coin)
priceStringNoPrice of the order.
Required if the order type is limit
sideStringYesOrder direction
buy: Buy
sell: Sell
tradeSideStringNoDirection
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"
orderTypeStringYesOrder type
limit: limit orders
market: market orders
forceStringNoOrder 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
clientOidStringNoCustomize order ID,The idempotency time is 20 minutes
reduceOnlyStringNoWhether or not to just reduce the position: YES, NO
Default: NO.
Applicable only in one-way-position mode
presetStopSurplusPriceStringNoTake-profit value
No take-profit is set if the field is empty.
presetStopLossPriceStringNoStop-loss value
No stop-loss is set if the field is empty.
stpModeStringNoSTP 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

ParameterTypeDescription
orderIdStringOrder ID
clientOidStringCustomize order ID