# 撤销订单频道

### 描述

1.限频与Rest API共享<br/>
2.使用时请求连接V2的websocket域名 wss://ws.bitget.com/v2/ws/private<br/>
3.暂时不支持批量撤单，每次请求仅限一单<br/>

<div className="api-aligning">

```json title="请求示例"
{
   "op":"trade",
   "args":[
      {
         "id":"xxxxx-xxx-xxx-xxxx-xxxxxx",
         "instType":"SPOT",
         "instId":"BTCUSDT",
         "channel":"cancel-order",
         "params":{
            "orderId":"xxxxxxxxx",
            "clientOid":"xxxxx-xxx-xxx-xxxx-xxxxxx"
         }
      }
   ]
}
```

### 请求参数

| 参数名                | 参数类型               | 是否必须 | 描述                                                          | 
|:-------------------|:-------------------|:-----|:------------------------------------------------------------|
| op                 | String             | 是    | "trade"                                                     |
| args               | List&lt;Object&gt; | 是    | 请求参数列表                                                      |
| &gt; id            | String             | 是    | 用户标识请求与返回<br/>长度&lt;= 40<br/>("^[0-9A-Za-z_:#\\-+\\s]*$");     |
| &gt; instType      | String             | 是    | 产品类型 `SPOT`                                                 |
| &gt; instId        | String             | 是    | 产品ID, 例如：`ETHUSDT`                                          |
| &gt; channel       | String             | 是    | 频道名, `cancel-order`                                         |
| &gt; params        | Object             | 是    |                                                             |
| &gt;&gt; orderId   | String             | 否    | 订单ID <br/> `orderId`与`clientOid`二选一必传，如果两者都传，优先`orderId`    |
| &gt;&gt; clientOid | String             | 否    | 用户自定义ID <br/> `orderId`与`clientOid`二选一必传，如果两者都传，优先`orderId` |

</div>

<div className="api-br-10"></div>

<div className="api-aligning">

```json title="响应示例"
{
  "event":"trade",
  "arg":[
    {
      "id":"xxxxx-xxx-xxx-xxxx-xxxxxx",
      "instType":"SPOT",
      "channel":"cancel-order",
      "instId":"BTCUSDT",
      "params":{
        "orderId":"xxxxxxxxxxx",
        "clientOid":"xxxxx-xxx-xxx-xxxx-xxxxxx"
      }
    }
  ],
  "code":0,
  "msg":"Success"
}
```

### 响应参数

| 返回字段               | 参数类型                | 字段说明                                                        | 
|:-------------------|:--------------------|:------------------------------------------------------------|
| event              | String              | 事件<br/>`trade` 交易<br/>`error`参数错误                           |
| arg                | Object              | 订阅成功的频道                                                     |
| &gt; id            | String              | 用户标识请求与返回<br/>长度&lt;= 40<br/>("^[0-9A-Za-z_:#\\-+\\s]*$");     |
| &gt; instType      | String              | 产品类型 `SPOT`                                                 |
| &gt; instId        | String              | 产品ID, 例如：`ETHUSDT`                                          |
| &gt; channel       | String              | 频道名, `cancel-order`                                          |
| &gt; params        | Object              |                                                             |
| &gt;&gt; orderId   | String              | 订单ID <br/> `orderId`与`clientOid`二选一必传，如果两者都传，优先`orderId`    |
| &gt;&gt; clientOid | String              | 用户自定义ID <br/> `orderId`与`clientOid`二选一必传，如果两者都传，优先`orderId` |
| code               | String              | 状态码                                                         |
| msg                | String              | 状态消息                                                        |

</div>