> 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/en-docs/websocket/websocket-unsubscribe-method/unsubscribe-from-real-time-candlestick-k-line-data.md).

# Unsubscribe from Real-Time Candlestick (K-Line) Data

### API Description

This document describes how to **fully cancel** or **partially cancel** product subscriptions without disconnecting the WebSocket connection.

### Request Frequency

For the same WebSocket connection, all requests (subscription, unsubscription, heartbeat) are limited to **60 times per minute**. If the request frequency limit is exceeded, the connection will be automatically disconnected. If there are too many disconnections and the system determines it as a malicious request, the API key will be blocked. Please pay attention to the calling logic during use.

### Error Code Description

Refer to [WebSocket Error Code Description](/en-docs/getting-started/error-codes/websocket-error-codes.md)

### Endpoint

Please refer to [WebSocket Subscription Endpoints](/en-docs/websocket/subscription-address.md)

### Request (Protocol Code: 11002)

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

> **Note**: The `data`, `codes`, or `klineTypes` parameter can be null or empty.
>
> * If the `codes` value cannot be obtained, a full cancellation will be performed. That is, if you have subscribed to candlestick data of 100 product pairs, all subscription data will be cleared and no further pushes will be made. If the `codes` value is provided, only the subscription data of the specified products will be cleared, and the data push of other products will not be affected.
> * If the `klineTypes` value cannot be obtained, all candlestick types (1-minute to 1-year) of the target products will be canceled. If the `klineTypes` value is provided, only the data push of the specified candlestick types will be cleared.
> * Example: Suppose you have subscribed to 1-minute and 5-minute candlesticks for products A and B. If the request parameters are `codes="A"` and `klineTypes="1"`, only the 1-minute candlestick push for product A will be canceled. This will not affect the 5-minute candlestick push for product A, nor the 1-minute and 5-minute candlestick pushes for product B.

| Parameter Name | Type    | Required | Description                                                                    | Example Value                                                            |
| -------------- | ------- | -------- | ------------------------------------------------------------------------------ | ------------------------------------------------------------------------ |
| `code`         | Integer | Yes      | Request protocol code                                                          | Protocol code for unsubscribing from real-time candlestick data: `11002` |
| `trace`        | String  | Yes      | Traceable ID (random string)                                                   | `423afec425004bd8a5e02e1ba5f9b2b0`                                       |
| `data`         | JSON    | No       | Unsubscription data                                                            |                                                                          |
| `codes`        | String  | No       | Products to unsubscribe from (separated by commas for multiple products)       | `BTCUSDT`                                                                |
| `klineTypes`   | String  | No       | Candlestick types to unsubscribe from (separated by commas for multiple types) | `1,2`                                                                    |

### Response (Protocol Code: 11010)

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

| Field Name | Type    | Required | Description                                     | Example Value                                                                     |
| ---------- | ------- | -------- | ----------------------------------------------- | --------------------------------------------------------------------------------- |
| `code`     | Integer | Yes      | Response protocol code                          | Response protocol code for unsubscribing from real-time candlestick data: `11010` |
| `trace`    | String  | Yes      | Traceable ID passed in the subscription request | `423afec425004bd8a5e02e1ba5f9b2b0`                                                |
| `msg`      | String  | Yes      | Response message                                | `ok`                                                                              |