Ws 合约批量撤单

cancel_batch_orders

是否验签: 是

接口权限: 交易

限频: 共享REST限频次数。

接口描述: 该接口支持websocket合约批量撤单。

订阅地址

环境	地址
线上环境	wss://api.sunx.io/ws/v1/trade
线上环境（aws客户首选）	wss://api.sunx.io/ws/v1/trade

订阅参数

字段名称	类型	说明
op	string	必填;操作名称为 cancel_batch_orders;
cid	string	选填; 请求唯一 ID
data	string	撤单的参数

请求参数

参数	数据类型	是否必填	描述	取值范围	默认值
<data>		false
contract_code	String	true	合约代码
order_id	array	false	订单ID
client_order_id	array	false	客户订单ID	[1-9223372036854775807]
<data>		false
cid	string	false	表示本次请求id

备注: 备注:order_id和client_order_id必须传一个，若两个都传，已order_id为准。

返回参数

参数	数据类型	是否必填	描述	取值范围
code	int	true	响应编码	200：成功、非200：失败
message	string	true	响应描述
<data>		false
code	int	true	订单撤单结果	200：成功、非200：失败
message	string	true	订单撤单结果描述
order_id	string	true	订单ID
client_order_id	string	true	客户订单ID
</data>		false
ts	long	true	响应生成时间点，单位：毫秒

订阅示例

{
  "op": "cancel_batch_orders",
  "cid": "cancel_batch_orders_1240",
  "data": {
    "contract_code": "BTC-USDT",
    "order_id": [
      "1329854623927160832",
      "1329854624082350080"
    ],
    "client_order_id": [
      "1329854623927160832",
      "1329854624082350080"
    ]
  }
}

订阅成功示例

{
  "code": 200,
  "message": "Success",
  "data": [
    {
      "orderId": "1358944125296009216",
      "clientOrderId": "1358944125296009216",
      "code": 200,
      "message": "Success"
    },
    {
      "orderId": "1358944503467040768",
      "clientOrderId": "1358944503467040768",
      "code": 200,
      "message": "Success"
    }
  ],
  "ts": 1744041034439,
  "cid": "cancel_batch_orders_1240"
}