# 取消訂閱

`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
{}
```
