# 實時報價

`WS` `request · cmd 11`

> **行情權限要求 · 免費**
> 美股：預設免費贈送 US LV1 實時行情（含盤前、盤中、盤後、夜盤全時段）；夜盤數據需設置 LONGBRIDGE_ENABLE_OVERNIGHT=true 開啟（詳見 Broker FAQ Q6、Q7）。
> 港股：預設贈送 LV1 實時行情。
> 美股期權：預設無權限，需購買「OPRA 美股期權行情 (OpenAPI)」行情卡。
> _OpenAPI 行情權限獨立於 App/Web 行情權限_

該接口用於獲取標的的實時行情 (支持所有類型標的）。如需查看這些實時數據流匯聚而成的實時指數、板塊熱力圖與宏觀市場概覽，可參考 [長橋全球市場](https://longbridge.com/en/markets)。

```protobuf
message MultiSecurityRequest {
  repeated string symbol = 1;
}

message SecurityQuoteResponse {
  repeated SecurityQuote secu_quote = 1;
}
```

## Request Parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `symbol` | string[] | Yes | 標的代碼列表，使用 ticker.region 格式；每次請求上限 500 個 |

## Response Fields

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `secu_quote` | object[] | No | 標的實時行情數據列表 |
| `└ symbol` | string | No | 標的代碼 |
| `└ last_done` | string | No | 最新價 |
| `└ prev_close` | string | No | 昨收價 |
| `└ open` | string | No | 開盤價 |
| `└ high` | string | No | 最高價 |
| `└ low` | string | No | 最低價 |
| `└ timestamp` | int64 | No | 最新成交的時間戳 |
| `└ volume` | int64 | No | 成交量 |
| `└ turnover` | string | No | 成交額 |
| `└ trade_status` | int32 | No | 標的交易狀態 |
| `└ pre_market_quote` | object | No | 美股盤前交易行情 |
| ` └ last_done` | string | No | 最新價 |
| ` └ timestamp` | int64 | No | 最新成交的時間戳 |
| ` └ volume` | int64 | No | 成交量 |
| ` └ turnover` | string | No | 成交額 |
| ` └ high` | string | No | 最高價 |
| ` └ low` | string | No | 最低價 |
| ` └ prev_close` | string | No | 上一個交易階段的收盤價 |
| `└ post_market_quote` | object | No | 美股盤後交易行情 |
| ` └ last_done` | string | No | 最新價 |
| ` └ timestamp` | int64 | No | 最新成交的時間戳 |
| ` └ volume` | int64 | No | 成交量 |
| ` └ turnover` | string | No | 成交額 |
| ` └ high` | string | No | 最高價 |
| ` └ low` | string | No | 最低價 |
| ` └ prev_close` | string | No | 上一個交易階段的收盤價 |
| `└ over_night_quote` | object | No | 美股夜盤交易行情；需開啟 enable_overnight 參數，否則返回 null（僅支援美股） |
| ` └ last_done` | string | No | 最新價 |
| ` └ timestamp` | int64 | No | 最新成交的時間戳 |
| ` └ volume` | int64 | No | 成交量 |
| ` └ turnover` | string | No | 成交額 |
| ` └ high` | string | No | 最高價 |
| ` └ low` | string | No | 最低價 |
| ` └ prev_close` | string | No | 上一個交易階段的收盤價 |

## Response JSON Example

```json
{
  "secu_quote": [
    {
      "symbol": "700.HK",
      "last_done": "338.000",
      "prev_close": "334.800",
      "open": "340.600",
      "high": "340.600",
      "low": "333.000",
      "timestamp": 1651115955,
      "volume": 7310881,
      "turnover": "2461463161.000"
    }
  ]
}
```
