# 期權實時報價

`WS` `request · cmd 12`

> **行情權限要求 · OPRA 期權**
> 新入金客戶預設無美股期權行情權限，需到行情商店購買「OPRA 美股期權行情 (OpenAPI)」行情卡，以獲取美股期權實時數據。
> _OpenAPI 行情權限獨立於 App/Web 行情權限_

該接口用於獲取美股期權標的的實時行情，包括期權的特有數據。

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

message OptionQuoteResponse {
  repeated OptionQuote secu_quote = 1;
}
```

## Request Parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `symbol` | string[] | Yes | 標的代碼列表，通過期權鏈接口獲取期權標的的 symbol，例如：[BABA230120C160000.US]。每次請求上限 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 | 標的交易狀態，詳見 TradeStatus |
| `└ option_extend` | object | No | 期權擴展行情 |
| ` └ implied_volatility` | string | No | 隱含波動率 |
| ` └ open_interest` | int64 | No | 未平倉數 |
| ` └ expiry_date` | string | No | 到期日，使用 YYMMDD 格式 |
| ` └ strike_price` | string | No | 行權價 |
| ` └ contract_multiplier` | string | No | 合約乘數 |
| ` └ contract_type` | string | No | 期權類型：A - 美式，U - 歐式 |
| ` └ contract_size` | string | No | 合約規模 |
| ` └ direction` | string | No | 方向：P - put，C - call |
| ` └ historical_volatility` | string | No | 對應正股的歷史波動率 |
| ` └ underlying_symbol` | string | No | 對應的正股標的代碼 |

## Response JSON Example

```json
{
  "secu_quote": [
    {
      "symbol": "AAPL220429P162500.US",
      "last_done": "7.78",
      "prev_close": "4.13",
      "timestamp": 1651003200,
      "volume": 3082,
      "turnover": "1813434.00",
      "option_extend": {
        "implied_volatility": "0.592",
        "open_interest": 11463,
        "expiry_date": "20220429",
        "strike_price": "162.50",
        "contract_type": "A",
        "direction": "P",
        "underlying_symbol": "AAPL.US"
      }
    }
  ]
}
```
