# 权证实时报价

`WS` `request · cmd 13`

> **行情权限要求 · 免费**
> 开通 OpenAPI 后自动获得，无需额外购买。
> _OpenAPI 行情权限独立于 App/Web 行情权限_

该接口用于获取港股轮证标的的实时行情，包括轮证的特有数据。

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

message WarrantQuoteResponse {
  repeated WarrantQuote secu_quote = 2;
}
```

## Request Parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `symbol` | string[] | Yes | 标的代码列表，使用 ticker.region 格式，例如：[13447.HK]。每次请求上限 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 |
| `└ warrant_extend` | object | No | 轮证扩展行情 |
| ` └ implied_volatility` | string | No | 引申波幅 |
| ` └ expiry_date` | string | No | 到期日，使用 YYMMDD 格式 |
| ` └ last_trade_date` | string | No | 最后交易日，使用 YYMMDD 格式 |
| ` └ outstanding_ratio` | string | No | 街货比 |
| ` └ outstanding_qty` | int64 | No | 街货量 |
| ` └ conversion_ratio` | string | No | 换股比率 |
| ` └ category` | string | No | 轮证类型：Call 认购证，Put 认沽证，Bull 牛证，Bear 熊证，Inline 界内证 |
| ` └ strike_price` | string | No | 行权价 |
| ` └ upper_strike_price` | string | No | 上限价 |
| ` └ lower_strike_price` | string | No | 下限价 |
| ` └ call_price` | string | No | 收回价 |
| ` └ underlying_symbol` | string | No | 对应的正股标的代码 |

## Response JSON Example

```json
{
  "secu_quote": [
    {
      "symbol": "66642.HK",
      "last_done": "0.345",
      "prev_close": "0.365",
      "timestamp": 1651130421,
      "volume": 200000,
      "turnover": "69000.000",
      "warrant_extend": {
        "implied_volatility": "0.319",
        "expiry_date": "20220830",
        "category": "Bear",
        "strike_price": "23200.000",
        "underlying_symbol": "HSI.HK"
      }
    }
  ]
}
```
