Skip to main content

Place Plan Order

Frequency limit: 20 times/1s (UID)

Description

Place plan order

HTTP Request

  • POST /api/v2/spot/trade/place-plan-order
Request Example
curl -X POST "https://api.cointr.com/api/v2/spot/trade/place-plan-order" \
-H "ACCESS-KEY:your apiKey" \
-H "ACCESS-SIGN:*" \
-H "ACCESS-PASSPHRASE:*" \
-H "ACCESS-TIMESTAMP:1659076670000" \
-H "locale:en-US" \
-H "Content-Type: application/json" \
-d '{"symbol": "TRXUSDT", "side": "buy", "triggerPrice": 0.041572, "executePrice": "0.041572", "size": 151, "triggerType": "market_price", "orderType": "limit","clientOid": "12345", "force": "gtc"}'

Request Parameter

ParameterTypeRequiredDescription
symbolStringYesTrading pair name, e.g. BTCUSDT
sideStringYesDirection
buy: Buy
sell: Sell
triggerPriceStringYesTrigger price
orderTypeStringYesOrder type
limit: Limit orders
market: Market orders
executePriceStringNoExecution price
it's required when orderType=limit
planTypeStringNoOrder type
amount: By amount of the order(base coin)
total: By trading volume of the order(quote coin)
The default value is amount
sizeStringYesQuantity to buy
If planType=amount, it is the base coin.
If planType=total, it is the quote coin.
triggerTypeStringYesTrigger type
fill_price: filled price
mark_price: mark price
clientOidStringNoClient customized ID. Only valid when orders are unfilled.
forceStringNoExecution strategy
Default value:gtc
gtc: normal limit order, good till canceled
post_only: Post only
fok: Fill or kill
ioc: Immediate or cancel
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": 1668134576535,
"data": {
"orderId": "121211212122",
"clientOid": "121211212122"
}
}

Response Parameter

ParameterTypeDescription
orderIdStringOrder ID
clientOidStringClient customized ID