设置持仓止盈止损

为已有持仓设置止盈止损，支持现货和合约交易。

限频：每秒 1 次

限速规则：UserID

请求地址

POST /deepcoin/trade/set-position-sltp

请求参数

字段名	是否必填	类型	字段描述
instType	是	string	产品类型现货: `SPOT` 合约: `SWAP`
instId	是	string	产品ID 例如：现货 `BTC-USDT`，合约 `BTC-USDT-SWAP`
posSide	否	string	持仓方向（合约必填）多头: `long` 空头: `short`
mrgPosition	否	string	保证金仓位模式（合约）合仓: `merge` 分仓: `split`
tdMode	否	string	交易模式（合约）全仓: `cross` 逐仓: `isolated`
posId	否	string	仓位ID（当 mrgPosition 为 `split` 时必填）
tpTriggerPx	否	string	止盈触发价止盈和止损至少填写一个
tpTriggerPxType	否	string	止盈触发价类型最新价: `last` 指数价: `index` 标记价: `mark` 默认: `last`
tpOrdPx	否	string	止盈委托价 `-1` 表示市价默认: `-1`
slTriggerPx	否	string	止损触发价止盈和止损至少填写一个
slTriggerPxType	否	string	止损触发价类型最新价: `last` 指数价: `index` 标记价: `mark` 默认: `last`
slOrdPx	否	string	止损委托价 `-1` 表示市价默认: `-1`
sz	否	string	持仓数量，用于部分止盈止损不填表示全部持仓

注意事项:

tpTriggerPx 和 slTriggerPx 至少需要提供一个
合约交易在分仓模式下（mrgPosition=split），必须提供 posId
现货交易不需要填写 posSide、mrgPosition、tdMode 和 posId

请求示例

现货 - 同时设置止盈和止损：

{
  "instType": "SPOT",
  "instId": "BTC-USDT",
  "tpTriggerPx": "107000",
  "slTriggerPx": "102000"
}

合约 - 为多头仓位设置止盈止损（合仓模式）：

{
  "instType": "SWAP",
  "instId": "BTC-USDT-SWAP",
  "posSide": "long",
  "mrgPosition": "merge",
  "tdMode": "cross",
  "tpTriggerPx": "107000",
  "slTriggerPx": "102000"
}

合约 - 为特定仓位设置止盈止损（分仓模式）：

{
  "instType": "SWAP",
  "instId": "BTC-USDT-SWAP",
  "posSide": "long",
  "mrgPosition": "split",
  "tdMode": "isolated",
  "posId": "1000596063679172",
  "tpTriggerPx": "107000",
  "tpTriggerPxType": "mark",
  "tpOrdPx": "-1",
  "slTriggerPx": "102000",
  "slTriggerPxType": "mark",
  "slOrdPx": "-1"
}

仅设置止盈：

{
  "instType": "SPOT",
  "instId": "BTC-USDT",
  "tpTriggerPx": "107000"
}

仅设置止损：

{
  "instType": "SPOT",
  "instId": "BTC-USDT",
  "slTriggerPx": "102000"
}

响应参数

字段名	类型	字段描述
ordId	string	止盈止损订单ID（用于取消订单）
sCode	string	事件执行结果的状态码 `0`: 成功
sMsg	string	事件执行失败时的消息

响应示例

成功响应：

{
  "code": "0",
  "msg": "",
  "data": {
    "ordId": "1001063717138767",
    "sCode": "0",
    "sMsg": ""
  }
}

失败响应：

{
  "code": "51000",
  "msg": "参数错误",
  "data": {
    "ordId": "",
    "sCode": "51000",
    "sMsg": "止盈和止损至少需要设置一个"
  }
}

说明

功能说明

为已有持仓设置止盈和/或止损
支持现货（SPOT）和合约（SWAP）交易
通过指定 sz 参数可以实现部分仓位止盈止损
支持不同的触发价类型（最新价、指数价、标记价）
可以设置市价或限价委托执行止盈止损

使用场景

风险管理：当价格达到目标或止损位时自动平仓
利润保护：当价格达到预期水平时锁定利润
损失限制：通过设置止损限制潜在损失
部分仓位管理：仅对部分仓位设置止盈止损

重要提示

订单ID：保存返回的 ordId 以便后续取消或修改止盈止损订单
价格精度：触发价格必须符合产品的价格精度要求
仓位验证：设置止盈止损前需确保有对应的持仓
覆盖规则：设置新的止盈止损可能会覆盖同一仓位的现有止盈止损订单
合约特殊性：合约交易需要正确指定持仓方向（posSide）和保证金模式

设置持仓止盈止损​

请求地址​

请求参数​

请求示例​

响应参数​

响应示例​

说明​

功能说明​

使用场景​

重要提示​

相关接口​