# 批量修改订单

### 描述

本频道响应采用「双层状态码」结构：
- **外层** `code` / `msg`：批量改单请求整体是否被受理
- **内层** `args[i].code` / `args[i].msg`：每笔订单的改单结果

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

:::tip

ACK 仅表示请求被成功接受，请使用 [WebSocket order](/zh-CN/docs/uta/websocket/private/Order-Channel) 推送来确认每笔订单的实际状态。

:::

- 不支持逐仓模式批量改单

<div className="api-aligning">

```json title="请求示例"
{
    "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",
    "topic": "batch-modify"
}
```

### 请求参数

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

</div>


<div className="api-aligning">

```json title="响应示例"
{
  "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",
      "receiveTime": "1750034396998123",
      "pushTime": "1750034397076456"
    },
    {
      "code": "0",
      "msg": "Success",
      "orderId": "1354240301222222222",
      "clientOid": "1354240301222222222",
      "receiveTime": "1750034396999456",
      "pushTime": "1750034397077789"
    }
  ],
  "code": "0",
  "msg": "Success",
  "connId": "xxxxxxxxxx",
  "rateLimit": [
    {
      "limit": "10",
      "remaining": "9"
    }
  ],
  "ts": "1758602036638"
}
```

### 响应参数说明

| 返回字段           | 参数类型               | 字段说明                              |
|:---------------|:-------------------|:----------------------------------|
| event          | String             | 事件<br/>`trade` 交易<br/>`error`参数错误 |
| id             | String             | 请求标识                              |
| topic          | String             | 频道名<br/>`batch-modify`批量修改订单      |
| args           | List&lt;Object&gt; | 订单列表                              |
| &gt; orderId   | String             | 订单ID                              |
| &gt; clientOid | String             | 自定义订单ID                           |
| &gt; receiveTime | String           | 网关接收时间 <br/>Unix微秒时间戳             |
| &gt; pushTime  | String             | 网关推送时间 <br/>Unix微秒时间戳             |
| &gt; code      | String             | 状态码                               |
| &gt; msg       | String             | 状态消息                              |
| code           | String             | 状态码                               |
| msg            | String             | 状态消息                              |
| connId         | String             | 连接ID                              |
| rateLimit      | Array              | 限频余额数组                            |
| &gt; limit     | String             | 该维度限额                             |
| &gt; remaining | String             | 剩余可用次数                            |
| ts             | String             | 时间戳                               |

</div>