跳到主要内容

取消持仓止盈止损

取消持仓止盈止损​

取消已设置的持仓止盈止损订单，支持现货和合约交易。

限频：每秒 1 次

限速规则：UserID

请求地址​

POST /deepcoin/trade/cancel-position-sltp

请求参数​

字段名是否必填类型字段描述
instType是string产品类型
现货: SPOT
合约: SWAP
instId是string产品ID
例如：现货 BTC-USDT，合约 BTC-USDT-SWAP
ordId是string止盈止损订单ID
通过设置接口返回或查询条件单获取

注意事项:

  • ordId 是通过 set-position-sltp API 设置止盈止损时返回的订单ID
  • 也可以通过查询待成交条件单来获取 ordId

请求示例​

取消现货持仓止盈止损：

{
  "instType": "SPOT",
  "instId": "BTC-USDT",
  "ordId": "1000762096073860"
}

取消合约持仓止盈止损：

{
  "instType": "SWAP",
  "instId": "BTC-USDT-SWAP",
  "ordId": "1000596068909100"
}

响应参数​

字段名类型字段描述
ordIdstring订单ID
sCodestring事件执行结果的状态码
0: 成功
sMsgstring事件执行失败时的消息

响应示例​

成功响应：

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

失败响应（订单不存在）：

{
  "code": "51400",
  "msg": "订单不存在",
  "data": {
    "ordId": "1000762096073860",
    "sCode": "51400",
    "sMsg": "订单不存在"
  }
}

失败响应（订单已执行）：

{
  "code": "51401",
  "msg": "订单已执行",
  "data": {
    "ordId": "1000762096073860",
    "sCode": "51401",
    "sMsg": "订单已执行或已取消"
  }
}

说明​

功能说明​

  • 取消已设置的持仓止盈止损订单
  • 支持现货（SPOT）和合约（SWAP）交易
  • 只能取消待成交的止盈止损订单（尚未触发）

使用场景​

  1. 策略调整：取消现有止盈止损以设置新的价格水平
  2. 市场变化应对：当市场条件变化时移除止盈止损
  3. 手动控制：改为手动控制仓位平仓而非自动止盈止损
  4. 错误纠正：取消错误设置的止盈止损订单

重要提示​

  1. 订单ID必需：必须有 set-position-sltp 响应中返回的 ordId
  2. 订单状态：只能取消待成交订单；已触发或已执行的订单无法取消
  3. 查询订单：使用 trigger-orders-pending API 查询现有止盈止损订单并获取其ID
  4. 时机把握：一旦止盈止损订单被触发，就无法取消
  5. 验证确认：取消前请确保订单属于您的账户

相关接口​

  • 设置持仓止盈止损：/deepcoin/trade/set-position-sltp - 设置新的止盈止损订单
  • 修改持仓止盈止损：/deepcoin/trade/modify-position-sltp - 修改已设置的止盈止损订单
  • 查询待成交条件单：/deepcoin/trade/trigger-orders-pending - 查询现有止盈止损订单
  • 查询条件单历史：/deepcoin/trade/trigger-orders-history - 查询历史止盈止损订单