Skip to main content

Place Order

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

Description

Place Order

HTTP Request

  • POST /api/v2/spot/trade/place-order
Request Example
curl -X POST "https://api.cointr.com/api/v2/spot/trade/place-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": "BTCUSDT","side": "buy","orderType": "limit","force":"gtc","price":"23222.5","size":"1","clientOid":"121211212122"}'

Request Parameter

ParameterTypeRequiredDescription
symbolStringYesTrading pair name
e.g. BTCUSDT
sideStringYesOrder Direction
buy: Buy
sell: Sell
orderTypeStringYesOrder type
limit: Limit order
market: Market order
forceStringYesExecution strategy(It will be invalid when orderType is market)
gtc: Normal limit order, good till cancelled
post_only: Post only
fok: Fill or kill
ioc: Immediate or cancel
priceStringNoLimit price
The decimal places of price and the price step can be returned by the Get Symbol Info interface
sizeStringYesAmount
For Limit and Market-Sell orders, it represents the number of base coins.
For Market-Buy orders, it represents the number of quote coins.
The decimal places of amount can be got trough Get Symbol Info interface
clientOidStringNoCustomed order ID. The idempotency time is 6 hours, only valid when orders are unfilled.
It's invalid when tpslType is tpsl
triggerPriceStringNoSPOT TP/SL trigger price, only requried in SPOT TP/SL order
tpslTypeStringNoOrder type, deafult value is normal
normal:SPOT order
tpsl:SPOT TP/SL order
requestTimeStringNoRequest Time, Unix millisecond timestamp
receiveWindowStringNoValid time window, Unix millisecond timestamp
If it's set, the request is valid only when the time range between the timestamp in the request and the time that server received the request is within receiveWindow
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": 1695808949356,
"data": {
"orderId": "1001",
"clientOid": "121211212122"
}
}

Response Parameter

ParameterTypeDescription
orderIdStringOrder ID
clientOidStringCustom order ID