窝轮筛选

POST /v1/quote/warrant-screen

窝轮筛选 — 在窝轮市场（认购证 CALL / 认沽证 PUT / 牛证 BULL / 熊证 BEAR / 界内证 INLINE）中按发行商、正股、价格、行使价、到期日、街货比、引伸波幅、杠杆、对冲值、轮证状态等维度组合筛选，支持多级排序与分页。

请求参数

参数	类型	位置	必填	说明
market_type	int	请求体	否	默认 1（HK）。允许取值：1=HK 港股、4=SG 新加坡、15=MY 马来西亚。
is_delay	bool	请求体	否	是否使用延时数据，默认 false。
only_count	bool	请求体	否	仅返回数量不返回明细列表，默认 false。
stock_owner	string	请求体	否	正股代码（便捷参数，自动转成 screen_groups 单条件，例 HK.00700）。需复杂筛选请用 screen_groups。
screen_groups	object[]	请求体	否	筛选条件列表。每元素结构 {field_id, interval{lower{value,is_included}, upper{value,is_included}}, choices[{content_type, value}]}。离散选择用 choices（多元素表 OR）；区间筛选用 interval。field_id 取值详见下方枚举表。
sorts	object[]	请求体	否	排序条件列表，每元素 {sort_field_id, sort_flag}。sort_flag=true 降序，false 升序。
next_key	string	请求体	否	翻页游标，首页留空；回传上一页 pagination.next_key。
limit	int	请求体	否	单页条数，默认 200，最大 1000。

枚举 wrnt_field（筛选 / 排序字段 field_id）

field_id	含义	形态/精度
4	ISSUER_ID 发行商 ID	choice
5	STOCK_OWNER 正股 ID	choice
6	WARRANT_TYPE 窝轮类型	choice（1=CALL, 2=PUT, 3=BULL, 4=BEAR, 5=INLINE）
7	CONVERSION_RATIO 换股比率	interval, x1e3
8	CURRENT_PRICE 当前价	interval, x1e3
9	STREET_RATIO 街货占比	interval, x1e3
10	VOLUME 成交量	interval
11	MATURITY_DATE 到期日	interval（秒级时间戳）
12	STRIKE_PRICE 行使价	interval, x1e3
13	PREMIUM 溢价	interval, x1e5
14	RECOVERY_PRICE 收回价	interval, x1e3
15	IMPLIED_VOLATILITY 引伸波幅	interval, x1e2
16	LEVERAGE_RATIO 杠杆	interval, x1e3
17	PRICE_RECOVERY_RATIO 正股距收回价 %	interval, x1e5
18	DELTA 对冲值	interval, x1e3
19	STATUS 状态	choice（0=NORMAL, 2=STOP_TRADE, 3=PRE_IPO）
20	IPO_TIME 上市时间	interval（秒级时间戳）
21	BUY_VOL 买量	interval
22	SELL_VOL 卖量	interval
23	EFFECTIVE_LEVERAGE 有效杠杆	interval, x1e3
24	LAST_CLOSE_PRICE 昨收价	interval, x1e3
25	TURNOVER 成交额	interval
26	SELL_PRICE 卖价	interval, x1e3
27	BUY_PRICE 买价	interval, x1e3
28	HIGH_PRICE 最高价	interval, x1e3
29	LOW_PRICE 最低价	interval, x1e3
30	RATIO_ITM_OTM 价内/价外 %	interval, x1e5
31	BREAK_EVEN_POINT 打和点	interval, x1e5
32	AMPLITUDE 振幅 %	interval, x1e5
33	SCORE_FAXING 法兴评分	interval, x1e5
34	LAST_TRADE_DATE 最后交易日	interval（秒级时间戳）
35	STREET_VOLUME 街货量	interval
36	LOT_SIZE 每手股数	interval
37	ISSUE_SIZE 发行量	interval
38	IPO_PRICE 发行价	interval, x1e3
39	LOWER_STRIKE_PRICE 下限价	interval, x1e3（仅界内证）
40	UPPER_STRIKE_PRICE 上限价	interval, x1e3（仅界内证）
41	IW_PRICE_STATUS 界内/界外	choice（0=界内, 1=界外上, 2=界外下）
42	SENSITIVITY 敏感度	interval, x1e3
43	CONVERSION_PRICE 换股价	interval
44	CHANGE_RATE 涨跌幅 %	interval, x1e3
45	CHANGE_VALUE 涨跌额	interval
51	SCORE 评分	interval, x1e5
52	FILTER_NO_TRADE 过滤无成交	choice（0=不过滤, 1=过滤）
53	CURRENCY_CODE 币种	interval
54	STOCK_OWNER_PRICE 正股价格	interval, x1e3

请求示例

curl -X POST "$ip/v1/quote/warrant-screen" \
  -H "Content-Type: application/json" \
  -d '{"market_type":1,"limit":3,"screen_groups":[{"field_id":6,"choices":[{"content_type":1,"value":1}]},{"field_id":5,"choices":[{"content_type":1,"value":54047868453564}]},{"field_id":19,"choices":[{"content_type":1,"value":0}]}],"sorts":[{"sort_field_id":16,"sort_flag":true}]}' | jq

响应字段

通用字段：

字段	类型	说明
code	string	窝轮 code，例 HK.18869。
name	string	窝轮名称。
stock_owner	string	正股 code，例 HK.00700。
type	string	窝轮类型：CALL / PUT / BULL / BEAR / INLINE / N/A。
issuer	string	发行商二字母代码（BC、BI、BP、CS、CT、DB、DC、EA、GS、HS、JP、KC、MB、ML、NM、RB、RS、SC、SG、UB、HT、VT、MS、GJ、XZ、HU、KS、CI）。
status	string	轮证状态：NORMAL / STOP_TRADE / PENDING_LISTING / N/A。
maturity_time	string	到期日（yyyy-MM-dd）。
maturity_timestamp	int	到期日，毫秒时间戳。
list_time	string	上市日（yyyy-MM-dd）。
list_timestamp	int	上市时间，毫秒时间戳。
last_trade_time	string	最后交易日（yyyy-MM-dd）。
last_trade_timestamp	int	最后交易日，毫秒时间戳。
lot_size	int	每手股数。
issue_size	int	发行量（股）。

价格 / 成交：

字段	类型	说明
cur_price	float	窝轮当前价。
last_close_price	float	昨收价。
high_price	float	最高价。
low_price	float	最低价。
bid_price	float	买一价。
ask_price	float	卖一价。
bid_vol	int	买一量（股）。
ask_vol	int	卖一量（股）。
volume	int	成交量（股）。
turnover	float	成交额。
price_change_val	float	涨跌额（cur_price - last_close_price）。
change_rate	float	涨跌幅，单位 %。
amplitude	float	振幅，单位 %。

衍生品指标：

字段	类型	说明
strike_price	float	行使价。
conversion_ratio	float	换股比率。
conversion_price	float	换股价。
break_even_point	float	打和点。
premium	float	溢价，单位 %。
ipop	float	价内/价外，单位 %（正=价内 / 负=价外）。
leverage	float	杠杆比率。
effective_leverage	float	有效杠杆。
delta	float	对冲值。
implied_volatility	float	引伸波幅，单位 %。
score	float	窝轮评分。
street_rate	float	街货占比，单位 %。
street_vol	int	街货量（股）。

牛熊证 / 界内证专属：

字段	类型	说明
recovery_price	float	收回价（仅牛/熊证）。
price_recovery_ratio	float	正股距收回价百分比（仅牛/熊证）。
upper_strike_price	float	上限价（仅界内证 INLINE）。
lower_strike_price	float	下限价（仅界内证 INLINE）。
inline_price_status	string	界内/界外：WITH_IN / OUTSIDE / N/A。

分页：

字段	类型	说明
pagination.total	int	满足条件的窝轮总数。
pagination.has_more	bool	是否还有下一页。
pagination.next_key	string	下一页游标；无更多页为 "-1"。

限制范围

• 支持市场：HK 港股 / SG 新加坡 / MY 马来西亚（market_type 取值 1 / 4 / 15）。其他市场不支持。
• 支持品类：CALL（认购证）、PUT（认沽证）、BULL（牛证）、BEAR（熊证）、INLINE（界内证）。
• 单页 limit 最大 1000，next_key 为不透明游标。
• 合法但无数据（如某市场暂无该类窝轮、过严筛选未命中）返回 ret_code=0 + data.warrants=[] + all_count=0。

错误码

ret_code	error.code	触发条件	处理建议
-3	invalid_parameter	market_type 不在 [1,4,15] / limit 越界（>1000）/ next_key 非法 / 其他参数类型不合法。	校正请求体后重试。
-7	invalid_symbol	stock_owner 传入的代码无法在证券缓存中解析。	通过基础接口确认正股代码合法性后重试。
-2 / -4 / -6	internal_error	网关内部错误（路由未就绪 / 构造后端请求失败 / 响应转换失败）。	重试；持续报错请联系网关方排查。

响应示例

{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "warrants": [
      {
        "code": "HK.25894",
        "name": "腾讯摩通六七购B.C",
        "stock_owner": "HK.00700",
        "issuer": "JP",
        "type": "CALL",
        "status": "NORMAL",
        "strike_price": 778.27,
        "cur_price": 0.01,
        "leverage": 453.2,
        "premium": 71.948,
        "street_rate": 5.9,
        "maturity_time": "2026-07-29"
      }
    ]
  },
  "pagination": { "has_more": true, "next_key": "3", "total": 335 }
}