# 計算指標

`WS` `request · cmd 26`

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

該接口用於獲取標的計算指標數據，根據請求指定的計算指標返回數據。

```protobuf
message SecurityCalcQuoteRequest {
  repeated string symbols = 1;
  repeated CalcIndex calc_index = 2;
}

message SecurityCalcQuoteResponse {
  repeated SecurityCalcIndex security_calc_index = 1;
}
```

## Request Parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `symbols` | string[] | Yes | 標的代碼列表，使用 ticker.region 格式，例如：[700.HK]。每次請求上限 500 個 |
| `calc_index` | int32[] | Yes | 計算指標，例如：[1,2,3]，詳見 CalcIndex |

## Response Fields

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `security_calc_index` | object[] | No | 標的指標數據 |
| `└ symbol` | string | No | 標的代碼 |
| `└ last_done` | string | No | 最新價 |
| `└ change_val` | string | No | 漲跌額 |
| `└ change_rate` | string | No | 漲跌幅 (返回百分比數據，不包含%符號) |
| `└ volume` | int64 | No | 成交量 |
| `└ turnover` | string | No | 成交額 |
| `└ ytd_change_rate` | string | No | 年初至今漲幅 (返回百分比數據，不包含%符號) |
| `└ turnover_rate` | string | No | 換手率 (返回百分比數據，不包含%符號) |
| `└ total_market_value` | string | No | 總市值 |
| `└ capital_flow` | string | No | 流入資金 |
| `└ amplitude` | string | No | 振幅 (返回百分比數據，不包含%符號) |
| `└ volume_ratio` | string | No | 量比 |
| `└ pe_ttm_ratio` | string | No | 市盈率 (TTM) |
| `└ pb_ratio` | string | No | 市淨率 |
| `└ dividend_ratio_ttm` | string | No | 股息率 (TTM) |
| `└ five_day_change_rate` | string | No | 五日漲幅 (返回百分比數據，不包含%符號) |
| `└ ten_day_change_rate` | string | No | 十日漲幅 (返回百分比數據，不包含%符號) |
| `└ half_year_change_rate` | string | No | 半年漲幅 (返回百分比數據，不包含%符號) |
| `└ five_minutes_change_rate` | string | No | 五分鐘漲幅 (返回百分比數據，不包含%符號) |
| `└ expiry_date` | string | No | 到期日 |
| `└ strike_price` | string | No | 行權價 |
| `└ upper_strike_price` | string | No | 上限價 |
| `└ lower_strike_price` | string | No | 下限價 |
| `└ outstanding_qty` | int64 | No | 街貨量 |
| `└ outstanding_ratio` | string | No | 街貨比 (返回百分比數據，不包含%符號) |
| `└ premium` | string | No | 溢價率 (返回百分比數據，不包含%符號) |
| `└ itm_otm` | string | No | 價內/價外 (返回百分比數據，不包含%符號) |
| `└ implied_volatility` | string | No | 隱含波動率 (返回百分比數據，不包含%符號) |
| `└ warrant_delta` | string | No | 對沖值 |
| `└ call_price` | string | No | 收回價 |
| `└ to_call_price` | string | No | 距收回價 (返回百分比數據，不包含%符號) |
| `└ effective_leverage` | string | No | 有效槓桿 |
| `└ leverage_ratio` | string | No | 槓桿比率 |
| `└ conversion_ratio` | string | No | 換股比率 |
| `└ balance_point` | string | No | 打和點 |
| `└ open_interest` | int64 | No | 未平倉數 |
| `└ delta` | string | No | Delta |
| `└ gamma` | string | No | Gamma |
| `└ theta` | string | No | Theta，原始值需除以 100 得到標準的每股每天值 |
| `└ vega` | string | No | Vega，原始值需除以 100 得到標準的每股每 1% IV 值 |
| `└ rho` | string | No | Rho，原始值需除以 100 得到標準的每股每 1% 利率值 |

## Response JSON Example

```json
{
  "security_calc_index": [
    {
      "symbol": "AAPL.US",
      "last_done": "131.880",
      "change_val": "-5.2500",
      "change_rate": "-3.83",
      "volume": "122207099",
      "turnover": "16269088361.000"
    }
  ]
}
```
