# 取消订阅

`WS` `request · cmd 7`

> **行情权限要求 · 免费**
> 开通 OpenAPI 后自动获得，无需额外购买。
> _OpenAPI 行情权限独立于 App/Web 行情权限_

该接口用于取消订阅标的行情数据。

```protobuf
message UnsubscribeRequest {
  repeated string symbol = 1;
  repeated SubType sub_type = 2;
  bool unsub_all = 3;
}

message UnsubscribeResponse {
}
```

## Request Parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `symbol` | string[] | Yes | 订阅的标的代码，例如：[700.HK]。每次请求最多 500 个 |
| `sub_type` | int32[] | Yes | 订阅的数据类型，例如：[1,2]，详见 SubType |
| `unsub_all` | bool | Yes | 是否全部取消；symbol 为空时取消所有订阅，否则取消这些标的的所有类型订阅 |

## Response JSON Example

```json
{}
```
