跳到主要内容

设置追踪止损/止盈

API说明​

此接口允许用户根据指定的回调率配置追踪止损(SL)和止盈(TP)机制，仅适用于已成交订单。要设置追踪SL/TP，用户必须提供有效的持仓ID。

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

注意事项​

  1. 此接口仅支持已成交订单。要设置追踪SL/TP，用户必须提供持仓ID。
  2. 请求参数"quantity"始终表示合约数量，即使"quantityUnit"设置为USDT计价。

认证​

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

请求方法​

POST

接口地址​

/v1/perpum/moveTPSL

频率限制​

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

请求参数​

参数必填类型描述
openIdtrueLong持仓ID
callbackRatetrueBigDecimal回调率，有效范围从0到1。例如：0.5表示50%的回调率。
triggerPricefalseBigDecimal激活价格
quantitytrueBigDecimal合约/USDT数量
quantityUnitfalseInteger指定数量单位：0：以USDT计价，1：以合约计价。注意：默认情况下，此参数设置为1（以合约计价）。

响应参数​

此接口不返回响应参数；收到"code:0"表示"成功"。

请求示例​

以下Python代码展示了如何在已成交订单上设置追踪止损/止盈。

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

params = {
        "openId": "2435521222632076385",     
        "callbackRate": "0.5",
        "quantity": 1,      
        "quantityUnit": 1    
        }
 
api_url = "/v1/perpum/moveTPSL"
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': ''}