Place Order
Do not include extra spaces in JSON strings in request body.
Limitation
The maximum untriggered stop orders for a single trading pair in one account is 20.
HTTP REQUEST
POST /api/v1/stop-order
Example
POST /api/v1/stop-order
{
"orderId": "vs8hoo8kpkmklv4m0038lql0"
}
API KEY PERMISSIONS
This endpoint requires the Spot Trading or Margin Trading permission.
REQUEST URL
This endpoint support Spot URL
REQUEST RATE LIMIT
Spot weight：2
PARAMETERS
Public order placement request parameters
| Param | Type | Mandatory | Description |
|---|---|---|---|
| clientOid | String | Yes | Client Order Id，unique identifier created by the user, the use of UUID is recommended, e.g. UUID, with a maximum length of 128 bits. |
| side | String | Yes | buy or sell |
| symbol | String | Yes | symbol, such as, ETH-BTC |
| type | String | No | Order type limit and market, The default is limit |
| remark | String | No | Order placement remarks, length cannot exceed 100 characters (UTF-8) |
| stop | String | No | Either loss or entry, the default is loss. Requires stopPrice to be defined. |
| stopPrice | String | Yes | trigger price. |
| stp | String | No | self trade prevention is divided into four strategies: CN, CO, CB , and DC, When type is limit (limit order), DC strategy is not supported |
| tradeType | String | No | The type of trading : TRADE（Spot）, MARGIN_TRADE (Cross Margin), MARGIN_ISOLATED_TRADE (Isolated Margin). Default is TRADE |
Additional Request Parameters Required by limit Orders
| Param | Type | Mandatory | Description |
|---|---|---|---|
| price | String | Yes | Specify price for currency |
| size | String | Yes | Specify quantity for currency |
| timeInForce | String | No | Order timing strategy GTC, GTT, IOC, FOK (The default is GTC) |
| cancelAfter | long | No | Cancel after n seconds，the order timing strategy is GTT |
| postOnly | boolean | No | passive order labels, this is disabled when the order timing strategy is IOC or FOK |
| hidden | boolean | No | Hidden or not (not shown in order book) |
| iceberg | boolean | No | Whether or not only visible portions of orders are shown in iceberg orders |
| visibleSize | String | No | Maximum visible quantity in iceberg orders |
Additional request parameters required by market orders
| Param | Type | Mandatory | Description |
|---|---|---|---|
| size | String | No | (Select one out of two: size or funds) |
| funds | String | No | (Select one out of two: size or funds) |
- When placing a market order, the size or funds must be set.
RESPONSES
| Param | Description |
|---|---|
| orderId | An order Id is returned once an order is successfully placed. |
Yes
No