跳到主要内容

合并仓位

合并仓位​

将同一产品、同一方向、满足合并条件的多个分仓仓位合并。

调用方只需要传入产品 ID 和要合并的仓位 ID 列表。系统会根据仓位信息自动识别仓位方向、保证金模式和产品分组。

请求地址​

POST /deepcoin/trade/merge-positions

请求参数​

字段名是否必填类型字段描述
instId是string产品 ID，例如 BTC-USDT-SWAP
posIds是[]string要合并的仓位 ID 列表，至少 2 个，最多 10 个

请求示例​

{
  "instId": "BTC-USDT-SWAP",
  "posIds": [
    "1000587858872759",
    "1000587858872760"
  ]
}

响应参数​

字段名类型字段描述
posIdstring合并后的仓位 ID。如果暂时无法返回合并后的仓位 ID，则返回空字符串
mergedPosIds[]string本次参与合并的仓位 ID
instIdstring产品 ID

响应示例​

{
  "code": "0",
  "msg": "",
  "data": {
    "posId": "1000587858872759",
    "mergedPosIds": [
      "1000587858872759",
      "1000587858872760"
    ],
    "instId": "BTC-USDT-SWAP"
  }
}

如果合并已受理，但暂时无法立即返回合并后的仓位 ID：

{
  "code": "0",
  "msg": "",
  "data": {
    "posId": "",
    "mergedPosIds": [
      "1000587858872759",
      "1000587858872760"
    ],
    "instId": "BTC-USDT-SWAP"
  }
}

说明​

功能描述​

  • 合并多个指定分仓仓位
  • 仅支持同一产品、同一方向的仓位合并
  • 仓位 ID 必须来自 获取持仓列表 接口返回的 posId
  • 合并成功后，可通过 获取持仓列表 查询最新仓位

注意事项​

  • posIds 至少包含 2 个仓位 ID，最多包含 10 个仓位 ID
  • posIds 中不能出现重复仓位 ID
  • 所有仓位必须属于当前 API Key 对应账户
  • 所有仓位的产品 ID 必须与请求中的 instId 一致
  • 所有仓位必须为同方向仓位，例如均为 long 或均为 short
  • 所有仓位必须是分仓，即 mrgPosition=split
  • 跟单、被跟、Webhook 等受限仓位不能合并
  • 存在平仓委托、止盈止损、加仓委托、追踪出场委托等未完成委托时，仓位不能合并