设置止损/止盈

API说明

此接口允许用户为已成交和未成交订单设置止盈(TP)和止损(SL)。

注意：设置止损/止盈仅通过RESTful API可用。

注意事项

1. 要为已成交订单设置SL/TP，请提供持仓ID。要为未成交订单设置SL/TP，请提供订单ID。
2. 要批量设置SL/TP，请参考合约 > 下单 > 批量设置SL/TP。

认证

这是一个私有接口，需要认证。有关使用RESTful API的详细信息，请参考简介 > 认证和代码示例 > 合约 > RESTful私有接口。

请求方法

POST

接口地址

/v1/perpum/TPSL

频率限制

该接口的调用频率限制为：每个 IP 和用户 ID 每2秒最多请求10次。
此外，该接口还受到全局频率限制的约束。
有关"全局速率限制"和"API限频策略"的详细信息，请参阅“频率限制”部分，跳转

请求参数

参数	必填	类型	描述
id	true	Long	订单ID（对于未成交订单）持仓ID（对于已成交订单）
instrument	false	String	交易品种基础货币（例如，BTC或btc）。此参数不区分大小写。注意：对于以数字开头的交易品种（例如1000PEPE），大写和小写格式都有效。
stopLossOrderPrice	false	BigDecimal	止损限价
stopProfitOrderPrice	false	BigDecimal	止盈限价
stopLossPrice	false	BigDecimal	止损价格
stopProfitPrice	false	BigDecimal	止盈价格
stopLossRate	false	BigDecimal	止损率
stopProfitRate	false	BigDecimal	止盈率

响应参数

参数	类型	描述
msg	String	成功执行时返回"Success"

请求示例

以下Python代码展示了如何使用订单ID为未成交订单设置止损/止盈

注意：完整代码示例请参考简介 > 认证和代码示例 > 合约 > RESTful私有接口。

params = {
        "id": "33308751688900817",           
        "instrument": "BTC",              
        "stopProfitPrice" : 95000, 
        "stopLossPrice" : 82000
        }
 
api_url = "/v1/perpum/TPSL"
method = "POST"
response_code, response_data = FuturesRestfulPrivate(params, api_url, method, sec_key, api_key)   # function FuturesRestfulPrivate() is defined in section (Introduction > Authentication & Code Snippet > Futures > RESTful Private Interface)

注意：完整Java代码示例请参考简介 > 认证和代码示例 > 合约 > RESTful私有接口。

响应示例

以下是上述Python请求返回的示例响应：

{'code': 0, 'msg': 'Success'}