# 訂閱行情

`WS` `request · cmd 6`

> **行情權限要求 · 免費**
> 開通 OpenAPI 後自動獲得，無需額外購買。
> _OpenAPI 行情權限獨立於 App/Web 行情權限_

該接口用於訂閱標的行情數據。

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

message SubscriptionResponse {
  repeated SubTypeList sub_list = 1;
}
```

## Request Parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `symbol` | string[] | Yes | 訂閱的標的代碼，例如：[700.HK]。每次請求最多 500 個，每個用戶最多同時訂閱 500 個 |
| `sub_type` | int32[] | Yes | 訂閱的數據類型，例如：[1,2]，詳見 SubType |
| `is_first_push` | bool | Yes | 訂閱後是否立刻進行一次數據推送（trade 不支持） |

## Response Fields

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `sub_list` | object[] | No | 訂閱的數據 |
| `└ symbol` | string | No | 標的代碼 |
| `└ sub_type` | int32[] | No | 訂閱的數據類型，詳見 SubType |

## Response JSON Example

```json
{
  "sub_list": [
    {
      "symbol": "700.HK",
      "sub_type": [
        1,
        2,
        3
      ]
    },
    {
      "symbol": "AAPL.US",
      "sub_type": [
        2
      ]
    }
  ]
}
```
