# 權證篩選

`WS` `request · cmd 23`

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

該接口用於獲取輪證行情列表數據，支持按不同字段排序和篩選輪證。

```protobuf
message WarrantFilterListRequest {
  string symbol = 1;
  FilterConfig filter_config = 2;
  int32 language = 3;
}

message WarrantFilterListResponse {
  repeated FilterWarrant warrant_list = 1;
  int32 total_count = 2;
}
```

## Request Parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `symbol` | string | Yes | 標的代碼，使用 ticker.region 格式，例如：700.HK |
| `filter_config` | object | Yes | 篩選條件 |
| `└ sort_by` | int32 | Yes | 根據哪一項數據進行排序，例如：0，序號見響應數據 OrderSequence 字段 |
| `└ sort_order` | int32 | Yes | 升降順序：0 - 升序，1 - 降序 |
| `└ sort_offset` | int32 | Yes | 分頁的第一條數據偏移量，例如 0 |
| `└ sort_count` | int32 | Yes | 分頁的每一頁數量，例如 20，填 0 時不分頁 |
| `└ type` | int32[] | No | 篩選輪證類型：0 認購，1 認沽，2 牛證，3 熊證，4 界內證 |
| `└ issuer` | int32[] | No | 篩選發行商，例如：[12,14]，發行商 ID 通過接口獲取 |
| `└ expiry_date` | int32[] | No | 篩選輪證過期時間：1 低於 3 個月，2 3-6 個月，3 6-12 個月，4 大於 12 個月 |
| `└ price_type` | int32[] | No | 篩選價內價外：1 價內，2 價外 |
| `└ status` | int32[] | No | 篩選狀態：2 終止交易，3 等待上市，4 正常 |
| `language` | int32 | Yes | 響應的語言：0 簡體，1 English, 2 繁體 |

## Response Fields

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `warrant_list` | object[] | No | 渦輪篩選數據列表 |
| `└ symbol` | string | No | 標的代碼 |
| `└ name` | string | No | 標的名稱 |
| `└ last_done` | string | No | 最新價 |
| `└ change_rate` | string | No | 漲跌幅 |
| `└ change_val` | string | No | 漲跌額 |
| `└ volume` | int64 | No | 成交量 |
| `└ turnover` | string | No | 成交額 |
| `└ expiry_date` | string | No | 到期日，使用 YYMMDD 格式 |
| `└ strike_price` | string | No | 行權價 |
| `└ upper_strike_price` | string | No | 上限價 |
| `└ lower_strike_price` | string | No | 下限價 |
| `└ outstanding_qty` | string | No | 街貨量 |
| `└ outstanding_ratio` | string | No | 街貨比 |
| `└ premium` | string | No | 溢價率 |
| `└ itm_otm` | string | No | 價內/價外 |
| `└ implied_volatility` | string | No | 引伸波幅 |
| `└ 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 | 打和點 |
| `└ status` | int32 | No | 狀態：2 終止交易，3 等待上市，4 正常 |
| `total_count` | int32 | No | 符合條件的輪證總數量 |

## Response JSON Example

```json
{
  "warrant_list": [
    {
      "symbol": "13157.HK",
      "name": "MBTENCT@EP2207A",
      "last_done": "2.26",
      "change_rate": "-0.0216",
      "expiry_date": "20220705",
      "strike_price": "442.233",
      "status": 4
    }
  ],
  "total_count": 1197
}
```
