> For the complete documentation index, see [llms.txt](https://docs.infoway.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.infoway.io/websocket-api/unsubscribe/trade-subscribe-3.md).

# 实时K线（Candles）取消订阅

展示如何在不断开Websocket连接的情况下，全量取消或者只取消一部分产品订阅

### 请求频率

同一连接所有请求（订阅、取消订阅、心跳）限制见 [WebSocket限制](/getting-started/api-limitation/websocket.md)（1 分钟 60 次）。超出将断连。

### 错误码说明

见 [WebSocket错误码](/getting-started/error-codes/websocket.md)。`klineTypes` 非法返回 `506`。

### 接口地址

见 [行情地址说明](/getting-started/api-endpoints.md)。

### 请求（协议号：11002）

只退 1 分钟、保留日线：

```json
{
    "code": 11002,
    "trace": "423afec425004bd8a5e02e1ba5f9b2b0",
    "data": {
        "codes": "BTCUSDT",
        "klineTypes": "1"
    }
}
```

退掉该品种全部周期：

```json
{
    "code": 11002,
    "trace": "423afec425004bd8a5e02e1ba5f9b2b0",
    "data": {
        "codes": "BTCUSDT"
    }
}
```

| 参数名          | 类型      | 必填 | 描述                                        | 示例值                                |
| ------------ | ------- | -- | ----------------------------------------- | ---------------------------------- |
| `code`       | Integer | 是  | K 线取消订阅协议号 `11002`                        | `11002`                            |
| `trace`      | String  | 是  | 可追溯 ID                                    | `423afec425004bd8a5e02e1ba5f9b2b0` |
| `data`       | JSON    | 否  | 取消范围。省略或 `null` 时取消当前连接全部 K 线品种           |                                    |
| `codes`      | String  | 否  | 逗号分隔。省略或 `null` = 当前连接已订的全部 K 线品种；不要传空字符串 | `BTCUSDT`                          |
| `klineTypes` | String  | 否  | 逗号分隔，取值 `1`–`12`。**不传 = 退掉这些品种的全部周期**     | `1,8`                              |

全部取消时可省略 `data`；不要用空字符串代替省略的 `codes` 或 `klineTypes`。`klineTypes` 空字符串不是合法周期。

只想退某一个周期时，必须带 `klineTypes`。省略该字段会把 1 分钟到年线全部退订。

周期取值与订阅相同：`1` 1 分钟 … `8` 日 … `12` 年。

### 应答（协议号：11010）

```json
{
    "code": 11010,
    "trace": "423afec425004bd8a5e02e1ba5f9b2b0",
    "msg": "ok"
}
```

成交 / 盘口 / K 线取消订阅成功都回 `11010`。