post https://api.connex.trade/api/v1/trading/order
Place a new order, this api is asynchronous. Returning success only means that the request is successful. The final result needs to be confirmed through websocket subscription and order query.Please contact connex, if any sub portfolio required special API limits setup.
Permission
- Applies to both primary user and trading portfolio's API Key.
- Permission: TRADE.
Rate Limit
- main portfolio 1200 requests per 60 seconds, sub-portfolio 20 requests per 10 seconds
Request
| Field name | Type | Necessary | Remarks |
|---|---|---|---|
| clientOrderId | String | N | Customer defined order ID ，only support letters(a-z) and numbers(0-9) |
| sym | String | Y | Sym(unique identifier：Exchange_Business_Base_Counter. Example: If you want to place a SPOT order for the BTC/USDT trading pair on the Binance exchange, you can use a unique identifier like this: "BINANCE_SPOT_BTC_USDT" ; If you want to place a PERPETUAL order for the BTC/USDT trading pair on the Binance exchange, you can use a unique identifier like this: "BINANCE_PERP_BTC_USDT" ; ) Note that we currently only support the SPOT and PERPETUAL trade of Binance and OKX. |
| side | String | Y | Side(BUY, SELL) |
| orderType | String | Y | Order type(default LIMIT, support type enums:LIMIT,MARKET) |
| timeInForce | String | Y | Limit Order：support type enums:GTC,IOC,FOK,GTX. GTX = GTC + Post only. Market Order：support type enums:GTC,IOC,FOK |
| orderQty | String | Y | Order quantity(Mandatory, unless spot market buy ) note: trading unit of OKX is the number of contracts/ trading unit of Binance is the number of coin |
| limitPrice | String | Conditional | Limit order price(if orderType=LIMIT，limitPrice must be fill in . Mandatory for limit order) |
| quoteOrderQty | String | Conditional | Order quote quantity, only use for spot market buy order |
| reduceOnly | String | N | Reduce position orders only, must "true" or "false" |
| positionSide | String | Y | Position side, NONE/LONG/SHORT, default NONE. NONE stands for one-way mode. |
| tpTriggerPrice | String | N | Take profit trigger price |
| tpTriggerType | String | N | Take profit trigger price type : LAST_PRICE or MARK_PRICE default LAST_PRICE |
| tpPrice | String | N | Take profit price; "0" indicates market price; default "0" |
| slTriggerPrice | String | N | Stop loss trigger price |
| slTriggerType | String | N | Stop loss trigger price type : LAST_PRICE or MARK_PRICE default LAST_PRICE |
| slPrice | String | N | Stop loss price ; "0" indicates market price; default "0" |
Response
| Field name | Type | Remarks |
|---|---|---|
| orderId | String | Order ID |
| clientOrderId | String | Customer defined order ID |