Place Stop Order
Info
- This endpoint requires signature. For specific signature rules, please refer to Authentication
- This endpoint will trigger rate limit. For specific rules, please refer to Rate Limit.
Dangerous
- When the server pressure level is too high, placing an order will trigger a 3008 error.
- When a 3008 error is triggered, the order cancellation request still has high priority, that is, the server will give priority to the order cancellation request.
- The balance will not be frozen until the stop order is triggered.
HTTP request
POST /futures/stop-order
Request parameters
Parameter Name | Required | Type | Notes |
---|---|---|---|
market | true | string | Market name |
market_type | true | string | Market type. Note: In spot related functions, only SPOT or MARGIN can be usedIn futures related functions, only FUTURES can be used |
side | true | string | Order side |
type | true | string | Order type |
amount | true | string | Order amount |
price | false | string | Order price |
trigger_price_type | true | string | Trigger price type, latest_price or mark_price or index_price |
trigger_price | true | string | Stop order trigger price |
client_id | false | string | User-defined ID |
is_hide | false | bool | Whether to hide the orders, default as: false |
stp_mode | false | string | Self-trading protection mode. ct: Cancel remaining Taker orders immediately cm: Cancel remaining Maker orders immediately (remaining taker orders are not affected if set as limit price orders, remaining untaken taker orders continue to stand with limit price) both: Cancel remaining Taker and Maker orders immediately Note: During the auction period, stop order stp_mode is not effective |
Return parameter
Parameter Name | Type | Notes |
---|---|---|
stop_id | int | Stop order ID |
Request example
{
"market": "CETUSDT",
"market_type": "FUTURES",
"side": "buy",
"type": "limit",
"amount": "10000",
"price": "1",
"trigger_price_type": "mark_price",
"trigger_price": "1.1",
"client_id": "user1",
"is_hide": true
}
Response example
{
"code": 0,
"data": {
"stop_id": 287330817
},
"message": "OK "
}