批量修改订单

描述

本频道响应采用「双层状态码」结构：

外层 code / msg：批量改单请求整体是否被受理
内层 args[i].code / args[i].msg：每笔订单的改单结果

外层 code=0 不代表所有子订单都成功。

提示

ACK 仅表示请求被成功接受，请使用 WebSocket order 推送来确认每笔订单的实际状态。

不支持逐仓模式批量改单

请求示例
{
    "args": [
        {
            "autoCancel": "yes",
            "clientOid": "1354237913333333333",
            "orderId": "1354237910333333333",
            "price": "5",
            "qty": "5"
        },
        {
            "autoCancel": "yes",
            "clientOid": "1354240301222222222",
            "orderId": "1354240301222222222",
            "price": "5",
            "qty": "2"
        }
    ],
    "id": "63210d1e-b400-47c7-afc6-323018afe71a",
    "op": "trade",
    "category": "usdt-futures",
    "topic": "batch-modify"
}

请求参数

参数名	参数类型	是否必须	描述
op	String	是	操作: `trade` 交易
id	String	是	请求标识
topic	String	是	频道名: `batch-modify` 批量修改订单
category	String	否	业务线,仅接受小写 `spot`现货交易 `margin` 杠杆交易 `usdt-futures` U本位合约 `coin-futures` 币本位合约 `usdc-futures` USDC合约
args	List<Object>	是	请求订阅的频道列表
> orderId	String	否	订单id orderId和clientOid二者必填其一如同时传入orderId及clientOid，则orderId优先级更高，忽略clientOid入参
> clientOid	String	否	自定义订单id orderId和clientOid二者必填其一如同时传入orderId及clientOid，则orderId优先级更高，忽略clientOid入参
> requestId	Number	否	自定义requestId，用于标识本次改单请求只支持18位以内的数字
> qty	String	否	下单数量 - 现货市价买单，单位为quote coin 限价及市价卖单，单位为base coin - 合约单位为base coin
> price	String	否	下单价格订单类型为限价单`limit`时，该字段必填订单类型为市价单`market`时，该字段失效
> autoCancel	String	否	修改订单失败是否撤销原订单 `yes`撤销 `no`不撤销若设置为 `yes`：撮合改单失败后，直接执行撤单；撤单后，柜台将拒绝该订单的后续改单请求（含在途及新请求）。
> symbol	String	否	交易对名称,不区分大小写

响应示例
{
  "event": "trade",
  "id": "63210d1e-b400-47c7-afc6-323018afe71a",
  "topic": "batch-modify",
  "args": [
    {
      "code": "25571",
      "msg": "The modification price and qty is the same as the original value. Please adjust and try again.",
      "orderId": "1354237913333333333",
      "clientOid": "1354237910333333333"
    },
    {
      "code": "0",
      "msg": "Success",
      "orderId": "1354240301222222222",
      "clientOid": "1354240301222222222"
    }
  ],
  "code": "0",
  "msg": "Success",
  "connId": "xxxxxxxxxx",
  "rateLimit": [
    {
      "limit": "10",
      "remaining": "9"
    }
  ],
  "receiveTime": "1750034396998123",
  "pushTime": "1750034397076456",
  "ts": "1758602036638"
}

响应参数说明

返回字段	参数类型	字段说明
event	String	事件 `trade` 交易 `error`参数错误
id	String	请求标识
topic	String	频道名 `batch-modify`批量修改订单
args	List<Object>	订单列表
> orderId	String	订单ID
> clientOid	String	自定义订单ID
> code	String	单笔订单改单状态码,`0`表示该单成功;其他为该单失败原因(例如`25571`改单价量与原订单相同)
> msg	String	单笔订单改单状态消息
code	String	批量请求整体受理状态码
msg	String	批量请求整体受理状态消息
connId	String	连接ID
rateLimit	Array	限频余额数组
> limit	String	该维度限额
> remaining	String	剩余可用次数
receiveTime	String	网关接收时间 Unix微秒时间戳
pushTime	String	网关推送时间 Unix微秒时间戳
ts	String	时间戳

批量修改订单

批量修改订单

描述​

请求参数​

响应参数说明​

您的阅读体验如何？

描述

请求参数

响应参数说明