批量平仓

批量平仓

批量平仓指定产品的所有仓位，支持现货、币本位合约、U本位合约

限频：每秒 1 次

请求地址

POST /deepcoin/trade/batch-close-position

请求参数

字段名	是否必填	类型	字段描述
productGroup	是	string	产品组 现货: Spot 币本位: Swap U本位: SwapU
instId	是	string	产品 ID

请求示例

// 批量平仓现货仓位
{
  "productGroup": "Spot",
  "instId": "BTC-USDT"
}

// 批量平仓币本位合约仓位
{
  "productGroup": "Swap",
  "instId": "BTC-USD-SWAP"
}

// 批量平仓U本位合约仓位
{
  "productGroup": "SwapU",
  "instId": "BTC-USDT-SWAP"
}

响应参数

字段名	类型	字段描述
errorList	array	错误列表，包含平仓失败的详细信息

errorList 中的 ClosePositionErrorItem 结构

字段名	类型	字段描述
memberId	string	会员 ID
accountId	string	账户 ID
tradeUnitId	string	交易单元 ID
instId	string	产品 ID
posiDirection	string	仓位方向
errorCode	int	错误码
errorMsg	string	错误信息

响应示例

// 成功响应（所有仓位都成功平仓）
{
  "code": "0",
  "msg": "",
  "data": {
    "errorList": []
  }
}

// 部分失败响应
{
  "code": "0",
  "msg": "",
  "data": {
    "errorList": [
      {
        "memberId": "10001",
        "accountId": "100001234",
        "tradeUnitId": "TU001",
        "instId": "BTC-USDT-SWAP",
        "posiDirection": "long",
        "errorCode": 51020,
        "errorMsg": "Insufficient position"
      },
      {
        "memberId": "10001",
        "accountId": "100001234",
        "tradeUnitId": "TU002",
        "instId": "BTC-USDT-SWAP",
        "posiDirection": "short",
        "errorCode": 51008,
        "errorMsg": "Order does not exist"
      }
    ]
  }
}

说明

功能描述

• 批量平仓指定产品的所有仓位
• 支持现货(Spot)、币本位合约(Swap)、U本位合约(SwapU)
• 使用并发处理提高效率
• 返回错误列表，包含所有平仓失败的详细信息

处理逻辑

1. 根据 productGroup 调用不同的服务（现货/合约）
2. 并发处理多个仓位的平仓操作
3. 收集所有平仓失败的错误信息
4. 即使部分仓位平仓失败，成功的仓位仍会被平仓

注意事项

• 该接口会平仓指定产品的所有仓位，请谨慎使用
• 错误列表为空表示所有仓位都成功平仓
• 部分仓位平仓失败不会影响其他仓位的平仓操作