# 权证筛选

`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
}
```
