筛选正股

• Python
• Proto
• C#
• Java
• C++
• JavaScript

get_stock_screen(request)

• 介绍

  条件选股 V2。相比旧接口 get_stock_filter，因子覆盖更广（11 类共 244+ 个因子），数值统一传原始值（OpenD 自动倍率转换），支持单字段或多字段排序、显式声明取回属性，结果按 value_type 分别填入 sval / ival / aval / dval。

• 参数

  参数	类型	说明
  request	StockScreenRequest	条件选股请求对象，通过 builder 方式构建

  • StockScreenRequest 字段：

    字段	类型	说明
    page_from	int	分页起始位置 不传默认为 0
    page_count	int	单页最大返回数 不传默认为 200

  • 筛选条件 builder 方法（每次调用追加一条筛选条件，所有数值字段直接传原始值，OpenD 自动倍率转换）：

    方法	说明
    add_simple_field(field, values)	市场 / 交易所 / 指数 / 自选股等枚举字段筛选 field 取自 SimpleField；values 为枚举值列表（OR 关系）。ScrMarket.MY / JP / SG 后续支持，目前结果为空
    add_plate(plate_ids, parent_plate_id=None)	板块筛选 plate_ids 形如 ["BK1001"]
    add_simple_property(name, lower=None, upper=None)	简单行情属性区间筛选 name 取自 SimpleProperty（最新价、市值、PE、量比等）；lower / upper 直接传原始值，如最新价 10 元传 10、市值 ≥ 100 亿传 10_000_000_000
    add_cumulative_property(name, days=1, lower=None, upper=None)	累计行情属性 name 取自 CumulativeProperty；days 用于 N 日累计。涨跌幅类（如 PRICE_CHANGE_PCT）传值为小数（5% 传 0.05，非 5.0）
    add_financial_property(name, term=None, year=None, lower=None, upper=None, ...)	财务属性 name 取自 FinancialProperty；term 取自 Term 枚举（Q1=1、年报=100、最新单季=10 等）。Term.SURPRISE_LATEST 系列（200~204）实测 HK/US 均会返回数值，但当前数据通常与 ANNUAL 相同，慎用
    add_indicator_positional(first_indicator_name, period_type, position, second_indicator=None, ...)	技术指标位置关系 如 MA5 上穿 MA20。指标名/周期/位置取自 Indicator / Period / Position
    add_indicator_pattern(name, period_type, ...)	技术指标形态（金叉、死叉、背离等） name 取自 Pattern
    add_featured_property(name, intervals=None, value_set=None, period=None, range_period=None, first_custom_param=None)	特色指标（筹码、热度、分析师评级、资金流等）
    add_broker_holdings(name, days=None, param=None, intervals=None)	经纪商持股因子 仅港股。经纪商因子 6101 / 6102 / 6105 / 6106 / 6107 倍率 1000，按百分数传值（如 20% 传 20）；days 参数不生效
    add_kline_shape(name, period=None, value_set=None)	K 线形态（双底、头肩底等） period 必传，目前仅支持日 K(11) 与 1 小时 K(21)
    add_option(name, intervals=None, param=None, period=None)	期权指标（正股 IV、HV 等）

  • 取回属性 builder 方法（声明返回哪些字段值；不声明则只返回 stock_id）：

    方法	说明
    add_retrieve_basic(name)	代码 / 名称 / 行业 name 取自 BasicProperty：CODE=1101、NAME=1102、INDUSTRY=1103
    add_retrieve_simple(name)	简单行情属性 name 取自 SimpleProperty
    add_retrieve_cumulative(name, days=1, period_average=None)	累计属性 name 取自 CumulativeProperty
    add_retrieve_financial(name, term=None, year=None, ...)	财务属性 name 取自 FinancialProperty
    add_retrieve_indicator(name, period=None, indicator_params=None)	技术指标
    add_retrieve_featured(name, period=None, range_period=None, first_custom_param=None)	特色属性
    add_retrieve_broker(name, days=None, param=None)	经纪商
    add_retrieve_option(name, param=None, period=None)	期权属性
    add_retrieve_kline_shape(name, period=None)	K 线形态 period 必传，否则不返回结果；目前仅支持日 K(11) 与 1 小时 K(21)

  • 排序 builder 方法：

    方法	说明
    set_sort(direction, property_type, property_params)	单字段排序 direction 取自 ScrSortDir：ASC=1、DESC=2、ABS_ASC=3、ABS_DESC=4。property_type 取 'basic' / 'simple' / 'cumulative' / 'financial' / 'indicator' / 'featured' / 'broker' / 'option' / 'kline_shape'
    add_sort(direction, property_type, property_params)	多字段排序 按调用顺序生效；与 set_sort 二选一，sortList 非空时优先

• 返回

  参数	类型	说明
  ret	RET_CODE	接口调用结果
  data	tuple	当 ret == RET_OK，返回 (last_page, all_count, items)
  	str	当 ret != RET_OK，返回错误描述

  • 返回 tuple 字段：

    字段	类型	说明
    last_page	bool	是否最后一页
    all_count	int	满足条件的总条数
    items	list[dict]	当前页结果列表，元素结构为 {'stock_id': int, 'results': [result, ...]}

  • 单条 result 结构：

    字段	类型	说明
    type	str	属性类型 'basic' / 'simple' / 'cumulative' / 'financial' / 'indicator' / 'featured' / 'broker' / 'option' / 'kline_shape'
    property	dict	对应 property 描述（含 name / days / term 等）
    value_type	int	值类型 1=string(sval)、2=int64(ival)、3=int64数组(aval)、4=double(dval)。当 OpenD 无数据时仅下发 value_type（多为 2），sval/ival/aval/dval 均缺失，如港股 Q2/Q3/Q4 财务数据
    sval	str	字符串值（value_type=1 时存在）
    ival	int	整型值（value_type=2 时存在）
    aval	list[int]	整型数组值（value_type=3 时存在）
    dval	float	浮点值（value_type=4 时存在）
    enum_type_name	str	当 ival 为枚举码时，对应的枚举类型名（如 'KlineShapeType'）
    enum_name	str	当 ival 为枚举码时，OpenD/SDK 解码出的枚举名（如 'DOUBLE_BOTTOMS'、'NONE'）
    end_time	int	财报结束时间戳 仅 financial 类型，且当前 OpenD 版本暂未下发，实际返回结果中通常没有该字段

• Example

from futu import OpenQuoteContext, RET_OK, StockScreenRequest
from futu.quote.stock_screen_const import (
    ScrMarket, ScrSortDir, SimpleField, SimpleProperty,
    CumulativeProperty, FinancialProperty, Term,
    Indicator, Period, Position, Pattern,
    BasicProperty, KlineShapeProperty, KlineShapeType,
)

quote_ctx = OpenQuoteContext(host='127.0.0.1', port=11111)

# 示例 1：港股大市值股 + MACD 金叉
req = StockScreenRequest()
req.add_simple_field(field=SimpleField.MARKET, values=[ScrMarket.HK])
req.add_simple_property(name=SimpleProperty.PRICE, lower=10.0)                   # 最新价 ≥ 10
req.add_simple_property(name=SimpleProperty.MARKET_CAP, lower=10_000_000_000.0)  # 市值 ≥ 100 亿
req.add_simple_property(name=SimpleProperty.PE_TTM, lower=10.0, upper=50.0)      # PE(TTM) 10~50
req.add_indicator_pattern(name=Pattern.MACD_GOLD_CROSS, period_type=Period.DAY)  # MACD 金叉
# 取回字段
req.add_retrieve_basic(name=BasicProperty.CODE)
req.add_retrieve_basic(name=BasicProperty.NAME)
req.add_retrieve_simple(name=SimpleProperty.PRICE)
req.add_retrieve_simple(name=SimpleProperty.MARKET_CAP)
req.add_retrieve_simple(name=SimpleProperty.PE_TTM)
# 排序
req.set_sort(direction=ScrSortDir.DESC, property_type='simple',
             property_params={'name': int(SimpleProperty.MARKET_CAP)})
req.page_count = 50

ret, data = quote_ctx.get_stock_screen(req)
if ret == RET_OK:
    last_page, all_count, items = data
    print(f"总数 {all_count}, 当前返回 {len(items)} 条")
    for it in items[:3]:
        print(it['stock_id'], it['results'])
else:
    print('error: ', data)

# 示例 2：财务因子 + 累计涨跌幅
req = StockScreenRequest()
req.add_simple_field(field=SimpleField.MARKET, values=[ScrMarket.HK])
req.add_cumulative_property(name=CumulativeProperty.PRICE_CHANGE_PCT,
                            days=5, lower=-0.05, upper=0.05)                     # 5 日涨跌幅 -5%~5%（百分数传小数）
req.add_financial_property(name=FinancialProperty.NET_PROFIT,
                           term=Term.ANNUAL, lower=0.0)                          # 年报净利润 > 0
req.add_retrieve_basic(name=BasicProperty.CODE)
req.add_retrieve_simple(name=SimpleProperty.PRICE)
req.page_count = 200
ret, data = quote_ctx.get_stock_screen(req)

# 示例 3：K 线形态（W 型底 + 头肩底）
req = StockScreenRequest()
req.add_simple_field(field=SimpleField.MARKET, values=[ScrMarket.HK])
req.add_kline_shape(name=KlineShapeProperty.SHAPE_TYPE, period=Period.DAY,
                    value_set=[KlineShapeType.DOUBLE_BOTTOMS,
                               KlineShapeType.HEAD_SHOULDERS_BOTTOM])
req.add_retrieve_basic(name=BasicProperty.CODE)
req.add_retrieve_kline_shape(name=KlineShapeProperty.SHAPE_TYPE, period=Period.DAY)
ret, data = quote_ctx.get_stock_screen(req)

quote_ctx.close()

• Output

总数 1, 当前返回 1 条
54047868453564 [{'type': 'basic', 'property': {'name': 1101}, 'value_type': 1, 'sval': '00700'},
                {'type': 'basic', 'property': {'name': 1102}, 'value_type': 1, 'sval': '腾讯控股'},
                {'type': 'simple', 'property': {'name': 2201}, 'value_type': 4, 'dval': 460.0},
                {'type': 'simple', 'property': {'name': 2301}, 'value_type': 4, 'dval': 4194280264040.0},
                {'type': 'simple', 'property': {'name': 2303}, 'value_type': 4, 'dval': 15.75126}]

• 字段逐项示例（按类别）

  以下示例均以 HK 市场为例：先 req = StockScreenRequest()，再 req.add_simple_field(field=SimpleField.MARKET, values=[ScrMarket.HK])， 再叠加每段中的筛选 / 取回 / 排序条件，最后 quote_ctx.get_stock_screen(req) 取 (last_page, all_count, items)。 实测的 head 已展开 results 数组里的对应 property 值（code/name 来自 BasicProperty.CODE/NAME，因子列名取自 SDK 字段名小写）。

  简单行情属性 SimpleProperty

  通过 add_simple_property(name, lower, upper) 传入；lower/upper 直传原始值（元/股/百分数 5% 传 5.0）

  PRICE（id=2201 · simple · SimpleProperty） 最新价

  单位：元；lower/upper 直传原始价，OpenD 自动倍率转换

  req.add_simple_property(name=SimpleProperty.PRICE, lower=10.0)
  req.add_retrieve_simple(name=SimpleProperty.PRICE)
  req.set_sort(direction=ScrSortDir.DESC, property_type='simple',
               property_params={'name': int(SimpleProperty.PRICE)})
  

  实测返回（HK · all_count=485、命中 5 行、head 前 5）：

        stock_id   code    name   price
  47704201761008  04336  应用材料-T  1620.0
  87836376173009  02513      智谱  1097.0
  47704201761005  04333    思科-T   750.0
  86839943761574  03750    宁德时代   672.5
  87840671141778  03986    兆易创新   653.5
  

  MARKET_CAP（id=2301 · simple · SimpleProperty） 总市值

  单位：元；lower=100 亿写 10_000_000_000

  req.add_simple_property(name=SimpleProperty.MARKET_CAP, lower=10_000_000_000.0)
  req.add_retrieve_simple(name=SimpleProperty.MARKET_CAP)
  req.set_sort(direction=ScrSortDir.DESC, property_type='simple',
               property_params={'name': int(SimpleProperty.MARKET_CAP)})
  

  实测返回（HK · all_count=591、命中 5 行、head 前 5）：

        stock_id   code    name        market_cap
  54047868453564  00700    腾讯控股   4222484299075.2
  83820581829436  80700  腾讯控股-R   3641391766113.6
  86839943761574  03750    宁德时代   3111406771825.0
  47704201761005  04333    思科-T   2956075998750.0
  57754425230710  01398    工商银行  2573253176182.58
  

  PE_TTM（id=2303 · simple · SimpleProperty） PE(TTM)

  正常区间筛选；可为负

  req.add_simple_property(name=SimpleProperty.PE_TTM, lower=5.0, upper=20.0)
  req.add_retrieve_simple(name=SimpleProperty.PE_TTM)
  req.set_sort(direction=ScrSortDir.ASC, property_type='simple',
               property_params={'name': int(SimpleProperty.PE_TTM)})
  

  实测返回（HK · all_count=830、命中 5 行、head 前 5）：

        stock_id   code      name  pe_ttm
  28604482191640  00280      景福集团     5.0
  67345087202619  01339  中国人民保险集团   5.037
  68629282424057  01273      香港信贷  5.0847
  76063870813891  01731    其利工业集团  5.0877
  35433480192608  00608      达利国际  5.0877
  

  VOLUME_RATIO（id=2217 · simple · SimpleProperty） 量比

  今日成交量 / N 日均量；> 2 表示放量

  req.add_simple_property(name=SimpleProperty.VOLUME_RATIO, lower=2.0)
  req.add_retrieve_simple(name=SimpleProperty.VOLUME_RATIO)
  req.set_sort(direction=ScrSortDir.DESC, property_type='simple',
               property_params={'name': int(SimpleProperty.VOLUME_RATIO)})
  

  实测返回（HK · all_count=340、命中 5 行、head 前 5）：

        stock_id   code      name  volume_ratio
  50796578209975  00183      宏辉集团         600.0
  45999099741384  01224      中渝置地       404.642
            1543  01543  中盈盛达融资担保       400.714
  24142011170996  00180      开达集团       314.999
   5033701671181  00269    中国资源交通         200.0
  

  DIVIDEND_RATIO（id=2305 · simple · SimpleProperty） 股息率

  单位：% ；股息率 ≥ 5% 传 5.0

  req.add_simple_property(name=SimpleProperty.DIVIDEND_RATIO, lower=5.0)
  req.add_retrieve_simple(name=SimpleProperty.DIVIDEND_RATIO)
  req.set_sort(direction=ScrSortDir.DESC, property_type='simple',
               property_params={'name': int(SimpleProperty.DIVIDEND_RATIO)})
  

  实测返回（HK · all_count=0、命中 0 行）：无数据。原因：HK 当下抽样无 ≥ 5% 股息率股票，可降低 lower 阈值

  累计行情属性 CumulativeProperty

  通过 add_cumulative_property(name, days, lower, upper) 传入；百分数类（涨跌幅/换手率）传小数（5% 传 0.05）

  PRICE_CHANGE_PCT（id=3102 · cumulative · CumulativeProperty） N 日涨跌幅 %

  百分数传小数：5% 传 0.05；days 指 N 日累计窗口

  req.add_cumulative_property(name=CumulativeProperty.PRICE_CHANGE_PCT,
                              days=5, lower=0.05)
  req.add_retrieve_cumulative(name=CumulativeProperty.PRICE_CHANGE_PCT, days=5)
  req.set_sort(direction=ScrSortDir.DESC, property_type='cumulative',
               property_params={'name': int(CumulativeProperty.PRICE_CHANGE_PCT), 'days': 5})
  

  实测返回（HK · all_count=363、命中 5 行、head 前 5）：

        stock_id   code      name  change_pct_5d
  88510686038921  02953     嬴集团股权            4.0
  77640123811704  01912       康特隆         2.7679
  47704201761005  04333      思科-T         2.2029
  88467736365964  02956  中国健康科技股权         1.6667
  47704201761008  04336    应用材料-T         1.4384
  

  AMPLITUDE（id=3103 · cumulative · CumulativeProperty） N 日振幅 %

  同 PRICE_CHANGE_PCT，百分数传小数

  req.add_cumulative_property(name=CumulativeProperty.AMPLITUDE,
                              days=20, lower=0.1)
  req.add_retrieve_cumulative(name=CumulativeProperty.AMPLITUDE, days=20)
  req.set_sort(direction=ScrSortDir.DESC, property_type='cumulative',
               property_params={'name': int(CumulativeProperty.AMPLITUDE), 'days': 20})
  

  实测返回（HK · all_count=2345、命中 5 行、head 前 5）：

        stock_id   code    name  amp_20d
  47704201761008  04336  应用材料-T  43.3783
  55671366092780  02028    映美控股   9.0893
  59558311493749  00117  天利控股集团   8.0532
  42623255446398  00894    万裕科技     7.59
  88433376627363  02723    深演智能   6.3243
  

  AVG_VOLUME（id=3104 · cumulative · CumulativeProperty） N 日均量

  单位：股；N 日成交量算术平均

  req.add_cumulative_property(name=CumulativeProperty.AVG_VOLUME,
                              days=20, lower=1_000_000)
  req.add_retrieve_cumulative(name=CumulativeProperty.AVG_VOLUME, days=20)
  req.set_sort(direction=ScrSortDir.DESC, property_type='cumulative',
               property_params={'name': int(CumulativeProperty.AVG_VOLUME), 'days': 20})
  

  实测返回（HK · all_count=2295、命中 5 行、head 前 5）：

        stock_id   code    name  avg_vol_20d
  84688165145005  02477    经纬天地  15586288027
  58506044508119  02007     碧桂园  11318232417
  69325067126991  02255  海昌海洋公园  10691740000
  81462644703252  00020    商汤-W   9517974535
  79671643350793  09993    金辉控股   7418314265
  

  TURNOVER_RATIO（id=3106 · cumulative · CumulativeProperty） N 日累计换手率

  单位：% ；百分数传小数（5% 传 0.05）

  req.add_cumulative_property(name=CumulativeProperty.TURNOVER_RATIO,
                              days=20, lower=0.05)
  req.add_retrieve_cumulative(name=CumulativeProperty.TURNOVER_RATIO, days=20)
  req.set_sort(direction=ScrSortDir.DESC, property_type='cumulative',
               property_params={'name': int(CumulativeProperty.TURNOVER_RATIO), 'days': 20})
  

  实测返回（HK · all_count=800、命中 5 行、head 前 5）：

        stock_id   code   name  turnover_ratio_20d
  58196806861368  00568   山东墨龙              6.7527
  84688165145005  02477   经纬天地              3.8966
  88089779243675  02715    埃斯顿              3.7288
  84434762074537  02473  喜相逢集团              3.4646
  87230785784391  02631   天岳先进              3.2208
  

  财务属性 FinancialProperty

  通过 add_financial_property(name, term, year, lower, upper) 传入；term 取自 Term 枚举（年报=100、Q1=1、TTM 类不需要 term）；比率类传小数（15% 传 0.15）

  NET_PROFIT（id=4101 · financial · FinancialProperty） 净利润

  单位：元；term=ANNUAL(100) 年报、Q1=1、Q2/Q3/Q4 部分港股无数据

  req.add_financial_property(name=FinancialProperty.NET_PROFIT,
                             term=Term.ANNUAL, lower=1_000_000_000.0)
  req.add_retrieve_financial(name=FinancialProperty.NET_PROFIT, term=Term.ANNUAL)
  req.set_sort(direction=ScrSortDir.DESC, property_type='financial',
               property_params={'name': int(FinancialProperty.NET_PROFIT),
                                'term': int(Term.ANNUAL)})
  

  实测返回（HK · all_count=437、命中 5 行、head 前 5）：

        stock_id   code    name      net_profit
  57754425230710  01398    工商银行  412328868600.0
  56186762167211  00939    建设银行  377880459000.0
  63586990818568  01288    农业银行  324736536300.0
  57118770073492  03988    中国银行  286850625600.0
  83820581829436  80700  腾讯控股-R  255561692100.0
  

  ROE（id=4110 · financial · FinancialProperty） 净资产收益率

  单位：% ；百分数传小数（15% 传 0.15）；term=ANNUAL

  req.add_financial_property(name=FinancialProperty.ROE,
                             term=Term.ANNUAL, lower=0.15)
  req.add_retrieve_financial(name=FinancialProperty.ROE, term=Term.ANNUAL)
  req.set_sort(direction=ScrSortDir.DESC, property_type='financial',
               property_params={'name': int(FinancialProperty.ROE),
                                'term': int(Term.ANNUAL)})
  

  实测返回（HK · all_count=322、命中 5 行、head 前 5）：

        stock_id   code    name      roe
  62487479191132  01628    禹洲集团   40.644
  69823283339309  08237    华星控股  12.6906
  52845277610549  00565  锦艺集团控股   3.0644
  86882893433405  02621    手回集团   2.7027
  64969970288874  02282   美高梅中国   2.6886
  

  REVENUE_GROWTH（id=4106 · financial · FinancialProperty） 营收同比增长率

  单位：% ；百分数传小数（20% 传 0.20）；term=ANNUAL

  req.add_financial_property(name=FinancialProperty.REVENUE_GROWTH,
                             term=Term.ANNUAL, lower=0.20)
  req.add_retrieve_financial(name=FinancialProperty.REVENUE_GROWTH, term=Term.ANNUAL)
  req.set_sort(direction=ScrSortDir.DESC, property_type='financial',
               property_params={'name': int(FinancialProperty.REVENUE_GROWTH),
                                'term': int(Term.ANNUAL)})
  

  实测返回（HK · all_count=638、命中 5 行、head 前 5）：

        stock_id   code    name  revenue_growth
  46772193854353  00913    港湾数字        106.7922
  88377542057458  07666  剂泰科技-P          73.067
  53047141075220  02324    首都创投         63.5792
  43589623088228  01124    沿海家园         26.7323
  74259984551169  03329    交银国际         20.5256
  

  BASIC_EPS（id=4801 · financial · FinancialProperty） 基本每股收益

  单位：元；term=ANNUAL

  req.add_financial_property(name=FinancialProperty.BASIC_EPS,
                             term=Term.ANNUAL, lower=1.0)
  req.add_retrieve_financial(name=FinancialProperty.BASIC_EPS, term=Term.ANNUAL)
  req.set_sort(direction=ScrSortDir.DESC, property_type='financial',
               property_params={'name': int(FinancialProperty.BASIC_EPS),
                                'term': int(Term.ANNUAL)})
  

  实测返回（HK · all_count=324、命中 5 行、head 前 5）：

        stock_id   code             name      basic_eps
  86998857554659  06883             颖通控股  123007487.548
  88261577939456  06656             思格新能        139.457
  69290707392656  06288  FAST RETAIL-DRS         74.984
  80418967660265  09961           携程集团-S         56.044
  85439784425509  06181             老铺黄金         31.388
  

  DIVIDENDS_TTM_RATIO（id=4219 · financial · FinancialProperty） TTM 股息率

  单位：% ；百分数传小数；TTM 类不需要 term/year

  req.add_financial_property(name=FinancialProperty.DIVIDENDS_TTM_RATIO, lower=0.05)
  req.add_retrieve_financial(name=FinancialProperty.DIVIDENDS_TTM_RATIO)
  req.set_sort(direction=ScrSortDir.DESC, property_type='financial',
               property_params={'name': int(FinancialProperty.DIVIDENDS_TTM_RATIO)})
  

  实测返回（HK · all_count=463、命中 5 行、head 前 5）：

        stock_id   code    name  div_ttm_ratio
  50856707752105  00169  万达酒店发展         4.0526
            2136  02136    利福中国         0.6562
  77622943942788  02180    万宝盛华         0.3752
  75419625726233  08473  弥明生活百货         0.3303
  64896955845349  02789    远大中国         0.2994
  

  技术指标位置关系 Indicator

  通过 add_indicator_positional(first_indicator_name, period_type, position, second_indicator=None, value=None, first_indicator_params=None) 传入；position 取自 Position（OVER=1、BELOW=2、CROSS_UP=3、CROSS_DOWN=4）

  MA5 / MA20（id=11 · indicator · Indicator） MA5 上穿 MA20

  add_indicator_positional：first/second 都是 Indicator 枚举；位置 CROSS_UP=3、CROSS_DOWN=4、OVER=1、BELOW=2

  req.add_indicator_positional(first_indicator_name=Indicator.MA5,
                               period_type=Period.DAY,
                               position=Position.CROSS_UP,
                               second_indicator=Indicator.MA20)
  

  实测返回（HK · all_count=67、命中 5 行、head 前 5）：

        stock_id   code    name
  88356067214548  01236   乐动机器人
  88313117542845  02493  迈威生物-B
  88179973556902  02726    瀚天天成
  87033217287972  01828    富卫集团
  86968792779992  03288    海天味业
  

  RSI（id=52 · indicator · Indicator） RSI 超买（>70）

  指标参数通过 first_indicator_params 传入，例如 RSI 周期 14；单值比较用 second_value

  req.add_indicator_positional(first_indicator_name=Indicator.RSI,
                               period_type=Period.DAY,
                               position=Position.OVER, second_value=70,
                               first_indicator_params=[14])
  

  实测返回（HK · all_count=97、命中 5 行、head 前 5）：

        stock_id   code     name
  88502096109937  08561  爱世纪集团股权
  88476326299379  01779   天辰生物-B
  88450556496782  02958  远见控股(旧)
  88416196762328  06872   丹诺医药-B
  88407606823814  02950  升能集团(旧)
  

  MACD_DIF（id=41 · indicator · Indicator） MACD DIF 在零轴上方

  second_value 为单值阈值；position=OVER 表示 DIF > 0

  req.add_indicator_positional(first_indicator_name=Indicator.MACD_DIF,
                               period_type=Period.DAY,
                               position=Position.OVER, second_value=0)
  

  实测返回（HK · all_count=786、命中 5 行、head 前 5）：

        stock_id   code      name
  88476326299379  01779    天辰生物-B
  88467736365964  02956  中国健康科技股权
  88450556496782  02958   远见控股(旧)
  88437671594888  02952  杭品生活科技股权
  88433376627363  02723      深演智能
  

  PRICE / BOLL_UPPER（id=1 · indicator · Indicator） 股价上穿布林上轨

  PRICE(1) 与 BOLL_UPPER(61) 比较位置

  req.add_indicator_positional(first_indicator_name=Indicator.PRICE,
                               period_type=Period.DAY,
                               position=Position.CROSS_UP,
                               second_indicator=Indicator.BOLL_UPPER)
  

  实测返回（HK · all_count=50、命中 5 行、head 前 5）：

        stock_id   code    name
  87544318404244  09876  大洋环球控股
  85864986184208  02576  太美医疗科技
  84482006714840  02520    山西安装
  83000243002163  06963    阳光保险
  82961588291781  02245    力勤资源
  

  技术指标形态 Pattern

  通过 add_indicator_pattern(name, period_type) 传入；name 取自 Pattern 枚举

  MACD_GOLD_CROSS（id=21 · pattern · Pattern） MACD 金叉

  add_indicator_pattern：name 取自 Pattern 枚举

  req.add_indicator_pattern(name=Pattern.MACD_GOLD_CROSS, period_type=Period.DAY)
  

  实测返回（HK · all_count=116、命中 5 行、head 前 5）：

        stock_id   code      name
  88502096109937  08561   爱世纪集团股权
  88416196764014  08558  麦迪森控股(旧)
  88265872906147  06051        有赞
  86998857553944  06168       周六福
  86822763895471  06831      绿茶集团
  

  KDJ_GOLD_CROSS（id=11 · pattern · Pattern） KDJ 金叉

  同上，K 上穿 D

  req.add_indicator_pattern(name=Pattern.KDJ_GOLD_CROSS, period_type=Period.DAY)
  

  实测返回（HK · all_count=179、命中 5 行、head 前 5）：

        stock_id   code           name
  88480621267856  02960  ALCO HOLD RTS
  88420491725703  02951        京玖康疗(旧)
  88179973556702  02526           德适-B
  87746181861167  03887  HASHKEY HLDGS
  87741886892639  02655           果下科技
  

  BOLL_BREAK_UPPER（id=41 · pattern · Pattern） 股价突破布林上轨

  BOLL 形态系列 41~44

  req.add_indicator_pattern(name=Pattern.BOLL_BREAK_UPPER, period_type=Period.DAY)
  

  实测返回（HK · all_count=50、命中 5 行、head 前 5）：

        stock_id   code    name
  87544318404244  09876  大洋环球控股
  85864986184208  02576  太美医疗科技
  84482006714840  02520    山西安装
  83000243002163  06963    阳光保险
  82961588291781  02245    力勤资源
  

  特色指标 FeaturedProperty

  通过 add_featured_property(name, intervals, value_set, period, range_period, first_custom_param) 传入；区间用 intervals=[(lower, upper)]，枚举用 value_set=[...]

  SHORT_POSITION（id=5110 · featured · FeaturedProperty） 空头持仓

  单位：股；不需 intervals

  req.add_featured_property(name=FeaturedProperty.SHORT_POSITION)
  req.add_retrieve_featured(name=FeaturedProperty.SHORT_POSITION)
  req.set_sort(direction=ScrSortDir.DESC, property_type='featured',
               property_params={'name': int(FeaturedProperty.SHORT_POSITION)})
  

  实测返回（HK · all_count=0、命中 0 行）：无数据。原因：该 featured 因子 HK 暂未暴露数据，需切换 US 市场查询

  ANALYST_RATING（id=5401 · featured · FeaturedProperty） 分析师评级

  枚举值：1=强烈买入、2=买入、3=持有、4=卖出、5=强烈卖出；value_set 传枚举列表

  req.add_featured_property(name=FeaturedProperty.ANALYST_RATING, value_set=[1, 2])
  req.add_retrieve_featured(name=FeaturedProperty.ANALYST_RATING)
  req.set_sort(direction=ScrSortDir.ASC, property_type='featured',
               property_params={'name': int(FeaturedProperty.ANALYST_RATING)})
  

  实测返回（HK · all_count=0、命中 0 行）：无数据。原因：需切换至覆盖率更高的 US 市场，或放宽 value_set

  ANALYST_TARGET_PRICE（id=5403 · featured · FeaturedProperty） 分析师目标价

  单位：元；区间用 dict 列表 [{'lower': {'value': X, 'includes': True}}]，上下限可省

  req.add_featured_property(name=FeaturedProperty.ANALYST_TARGET_PRICE,
                            intervals=[{'lower': {'value': 100.0, 'includes': True}}])
  req.add_retrieve_featured(name=FeaturedProperty.ANALYST_TARGET_PRICE)
  req.set_sort(direction=ScrSortDir.DESC, property_type='featured',
               property_params={'name': int(FeaturedProperty.ANALYST_TARGET_PRICE)})
  

  实测返回（HK · all_count=0、命中 0 行）：无数据。原因：需切换至覆盖率更高的 US 市场，或放宽 intervals 下限

  HIST_PERCENTILE_PE（id=5502 · featured · FeaturedProperty） 当前 PE 历史百分位

  range_period 必传：RangePeriod 枚举 (THREE_MONTHS=1、SIX_MONTHS=2、ONE_YEAR=3、THREE_YEARS=4)

  req.add_featured_property(name=FeaturedProperty.HIST_PERCENTILE_PE,
                            range_period=RangePeriod.THREE_YEARS,
                            intervals=[{'upper': {'value': 0.30, 'includes': True}}])
  req.add_retrieve_featured(name=FeaturedProperty.HIST_PERCENTILE_PE,
                            range_period=RangePeriod.THREE_YEARS)
  req.set_sort(direction=ScrSortDir.ASC, property_type='featured',
               property_params={'name': int(FeaturedProperty.HIST_PERCENTILE_PE),
                                'rangePeriod': int(RangePeriod.THREE_YEARS)})
  

  实测返回（HK · all_count=0、命中 0 行）：无数据。原因：HK 部分股票无历史 PE 数据，可放宽 range_period / intervals

  CASH_FLOW_MAIN_NET_IN（id=5901 · featured · FeaturedProperty） 主力资金净流入

  单位：元；资金流入用 CashFlowPeriod 枚举 (DAY=1、WEEK=2、MONTH_P=3、QUARTER=4)

  req.add_featured_property(name=FeaturedProperty.CASH_FLOW_MAIN_NET_IN,
                            range_period=CashFlowPeriod.DAY,
                            intervals=[{'lower': {'value': 10_000_000.0, 'includes': True}}])
  req.add_retrieve_featured(name=FeaturedProperty.CASH_FLOW_MAIN_NET_IN,
                            range_period=CashFlowPeriod.DAY)
  req.set_sort(direction=ScrSortDir.DESC, property_type='featured',
               property_params={'name': int(FeaturedProperty.CASH_FLOW_MAIN_NET_IN),
                                'rangePeriod': int(CashFlowPeriod.DAY)})
  

  实测返回（HK · all_count=0、命中 0 行）：无数据。原因：HK 实测无数据，建议改用 US 市场或更短周期

  经纪商持股 BrokerProperty

  通过 add_broker_holdings(name, days, param, intervals) 传入；仅港股；6101/6102/6105/6106/6107 倍率 1000，按百分数传值（20% 传 20）

  CONCENTRATED_DISTRIBUTION（id=6101 · broker · BrokerProperty） 经纪商集中度

  仅港股；intervals 按 dict 列表传，单位 %（20% 传 20.0）；param=经纪商代码逗号分隔

  req.add_broker_holdings(name=BrokerProperty.CONCENTRATED_DISTRIBUTION,
                          intervals=[{'lower': {'value': 20.0, 'includes': True}}])
  req.add_retrieve_broker(name=BrokerProperty.CONCENTRATED_DISTRIBUTION)
  req.set_sort(direction=ScrSortDir.DESC, property_type='broker',
               property_params={'name': int(BrokerProperty.CONCENTRATED_DISTRIBUTION)})
  

  实测返回（HK · all_count=0、命中 0 行）：无数据。原因：若 HK OpenD 未订阅 broker 行情则返回 0，可放低 lower

  CENTRAL_HOLDINGS_RATIO（id=6106 · broker · BrokerProperty） 中央结算系统持股占比

  仅港股；intervals 按 dict 列表传，单位 %

  req.add_broker_holdings(name=BrokerProperty.CENTRAL_HOLDINGS_RATIO,
                          intervals=[{'lower': {'value': 10.0, 'includes': True}}])
  req.add_retrieve_broker(name=BrokerProperty.CENTRAL_HOLDINGS_RATIO)
  req.set_sort(direction=ScrSortDir.DESC, property_type='broker',
               property_params={'name': int(BrokerProperty.CENTRAL_HOLDINGS_RATIO)})
  

  实测返回（HK · all_count=0、命中 0 行）：无数据。原因：若 HK OpenD 未订阅 broker 行情则返回 0，可放低 lower

  BROKER_NUM（id=6103 · broker · BrokerProperty） 持有该股的经纪商数量

  仅港股；整数（intervals 用 dict 列表）

  req.add_broker_holdings(name=BrokerProperty.BROKER_NUM,
                          intervals=[{'lower': {'value': 100, 'includes': True}}])
  req.add_retrieve_broker(name=BrokerProperty.BROKER_NUM)
  req.set_sort(direction=ScrSortDir.DESC, property_type='broker',
               property_params={'name': int(BrokerProperty.BROKER_NUM)})
  

  实测返回（HK · all_count=0、命中 0 行）：无数据。原因：若 HK OpenD 未订阅 broker 行情则返回 0

  K 线形态 KlineShapeProperty

  通过 add_kline_shape(name, period, value_set) 传入；period 必传，目前仅支持日 K(Period.DAY=11) 与 1 小时 K(Period.HOUR_1=5)

  SHAPE_TYPE（id=6200 · kline_shape · KlineShapeProperty） K 线形态识别

  period 必传：日 K=11、1 小时 K=5（实测发现 SDK 文档曾标注 21，但 21 实为周 K，应传 5）；value_set 取自 KlineShapeType

  req.add_kline_shape(name=KlineShapeProperty.SHAPE_TYPE, period=Period.DAY,
                      value_set=[KlineShapeType.DOUBLE_BOTTOMS,
                                 KlineShapeType.HEAD_SHOULDERS_BOTTOM])
  req.add_retrieve_kline_shape(name=KlineShapeProperty.SHAPE_TYPE, period=Period.DAY)
  

  实测返回（HK · all_count=0、命中 0 行）：无数据。原因：指定形态 + 区间无命中，可放宽 value_set

  RISE_PROB（id=6201 · kline_shape · KlineShapeProperty） 形态后上涨概率

  单位：% ；与 SHAPE_TYPE 联合使用

  req.add_kline_shape(name=KlineShapeProperty.SHAPE_TYPE, period=Period.DAY,
                      value_set=[KlineShapeType.DOUBLE_BOTTOMS])
  req.add_retrieve_kline_shape(name=KlineShapeProperty.RISE_PROB, period=Period.DAY)
  req.set_sort(direction=ScrSortDir.DESC, property_type='kline_shape',
               property_params={'name': int(KlineShapeProperty.RISE_PROB),
                                'period': int(Period.DAY)})
  

  实测返回（HK · all_count=0、命中 0 行）：无数据。原因：与 SHAPE_TYPE 联用；HK 抽样无命中

  期权属性 OptionProperty

  通过 add_option(name, intervals, param, period) 传入；用于按正股 IV / HV 等期权维度筛选

  STOCK_IV（id=1000 · option · OptionProperty） 正股期权隐含波动率

  单位：% ；intervals 用 dict 列表；period 取自 OptionHVPeriod (HV_30D/60D/90D/120D/365D)

  req.add_option(name=OptionProperty.STOCK_IV,
                 intervals=[{'lower': {'value': 30.0, 'includes': True}}])
  req.add_retrieve_option(name=OptionProperty.STOCK_IV)
  req.set_sort(direction=ScrSortDir.DESC, property_type='option',
               property_params={'name': int(OptionProperty.STOCK_IV)})
  

  实测返回（HK · all_count=0、命中 0 行）：无数据。原因：需切换至期权全集市场（US）或放低 intervals 下限

  STOCK_IV_RANK（id=1001 · option · OptionProperty） 正股 IV Rank

  0~100；衡量当前 IV 在历史中的相对位置（intervals 用 dict 列表）

  req.add_option(name=OptionProperty.STOCK_IV_RANK,
                 intervals=[{'lower': {'value': 50.0, 'includes': True}}])
  req.add_retrieve_option(name=OptionProperty.STOCK_IV_RANK)
  req.set_sort(direction=ScrSortDir.DESC, property_type='option',
               property_params={'name': int(OptionProperty.STOCK_IV_RANK)})
  

  实测返回（HK · all_count=0、命中 0 行）：无数据。原因：需切换至期权全集市场（US）或放低 intervals 下限

  STOCK_HV（id=1006 · option · OptionProperty） 正股历史波动率

  单位：% ；intervals 用 dict 列表；period 取自 OptionHVPeriod

  req.add_option(name=OptionProperty.STOCK_HV,
                 intervals=[{'lower': {'value': 20.0, 'includes': True}}])
  req.add_retrieve_option(name=OptionProperty.STOCK_HV)
  req.set_sort(direction=ScrSortDir.DESC, property_type='option',
               property_params={'name': int(OptionProperty.STOCK_HV)})
  

  实测返回（HK · all_count=0、命中 0 行）：无数据。原因：需切换至期权全集市场（US）或放低 intervals 下限

Qot_StockScreen.proto

• 介绍

  条件选股 V2

• 参数

message Boundary
{
    required double value = 1;
    optional bool includes = 2;     // 是否闭区间，默认 true
}

message Interval
{
    optional Boundary filterMin = 1;
    optional Boundary filterMax = 2;
}

// ===== 各类 PropertyXxx =====
message PropertyBasic         { required int32 name = 1; }
message PropertySimple        { required int32 name = 1; optional int32 unit = 2; }
message PropertyCumulative    {
    required int32 name = 1;
    required int32 days = 2;
    optional int32 periodAverage = 3;
    optional int32 unit = 4;
}
message PropertyFinancial     {
    required int32 name = 1;
    optional int32 term = 2;
    optional int32 year = 3;
    optional int32 duration = 4;
    optional int32 periodAverage = 5;
    optional int32 futureDuration = 6;
    optional int32 unit = 7;
}
message PropertyIndicator     {
    required int32 name = 1;
    optional int32 period = 2;
    repeated int32 indicatorParams = 3;
}
message PropertyFeatured      {
    required int32 name = 1;
    optional int32 period = 2;
    optional int32 rangePeriod = 3;
    optional int32 firstCustomParam = 4;
}
message PropertyBroker        {
    required int32 name = 1;
    optional int32 days = 2;
    optional string param = 3;
}
message PropertyOption        {
    required int32 name = 1;
    optional int32 period = 2;
    optional string param = 3;
}
message PropertyKlineShape    {
    required int32 name = 1;
    optional int32 period = 2;
}

// ===== 各类 QueryXxx =====
message SimpleFieldQuery
{
    required int32 simpleField = 1;
    repeated int32 screenValueList = 2;
}

message PlateInfo
{
    repeated string plateIdList = 1;
    optional string parentPlateId = 2;
}

message PlateQuery       { repeated PlateInfo plateList = 1; }

message SimplePropertyQuery
{
    required PropertySimple property = 1;
    optional Boundary filterMin = 2;
    optional Boundary filterMax = 3;
}

message CumulativePropertyQuery
{
    required PropertyCumulative property = 1;
    optional Boundary filterMin = 2;
    optional Boundary filterMax = 3;
    optional int32 continuousPeriod = 4;
}

message FinancialPropertyQuery
{
    required PropertyFinancial property = 1;
    optional Boundary filterMin = 2;
    optional Boundary filterMax = 3;
    optional int32 continuousPeriod = 4;
}

message IndicatorPositionalQuery
{
    required int32 firstIndicatorName = 1;
    required int32 periodType = 2;
    required int32 position = 3;
    optional int32 secondIndicator = 4;
    optional int32 secondValue = 5;
    repeated int32 firstIndicatorParams = 6;
    repeated int32 secondIndicatorParams = 7;
    optional int32 continuousPeriod = 8;
    repeated Interval intervals = 9;
}

message IndicatorPatternQuery
{
    required int32 name = 1;
    required int32 periodType = 2;
    optional int32 continuousPeriod = 3;
    optional bool isMatching = 4;
    repeated int32 subPatterns = 5;
}

message FeaturedPropertyQuery
{
    required PropertyFeatured property = 1;
    repeated Interval intervals = 2;
    repeated int32 valueSet = 3;
}

message BrokerHoldingsQuery
{
    required PropertyBroker property = 1;
    repeated Interval intervals = 2;
}

message KlineShapeQuery
{
    required PropertyKlineShape property = 1;
    repeated int32 valueSet = 2;
}

message OptionQuery
{
    required PropertyOption property = 1;
    repeated Interval intervals = 2;
}

// ===== 一条筛选条件 (oneof 多选一) =====
message ScreenQuery
{
    optional SimpleFieldQuery simpleFieldQuery = 1;
    optional PlateQuery plateQuery = 2;
    optional SimplePropertyQuery simplePropertyQuery = 3;
    optional CumulativePropertyQuery cumulativePropertyQuery = 4;
    optional FinancialPropertyQuery financialPropertyQuery = 5;
    optional IndicatorPositionalQuery indicatorPositionalQuery = 6;
    optional IndicatorPatternQuery indicatorPatternQuery = 7;
    optional FeaturedPropertyQuery featuredPropertyQuery = 8;
    optional BrokerHoldingsQuery brokerHoldingsQuery = 9;
    optional KlineShapeQuery klineShapeQuery = 10;
    optional OptionQuery optionQuery = 11;
}

// ===== 取回字段 =====
message RetrieveQuery
{
    optional PropertyBasic basicProperty = 1;
    optional PropertySimple simpleProperty = 2;
    optional PropertyCumulative cumulativeProperty = 3;
    optional PropertyFinancial financialProperty = 4;
    optional PropertyIndicator indicatorProperty = 5;
    optional PropertyFeatured featuredProperty = 6;
    optional PropertyBroker brokerProperty = 7;
    optional PropertyOption optionProperty = 8;
    optional PropertyKlineShape klineShapeProperty = 9;
}

// ===== 排序定义 =====
message Sort
{
    required int32 direction = 1;   // 1=ASC, 2=DESC, 3=ABS_ASC, 4=ABS_DESC
    optional PropertyBasic basicProperty = 2;
    optional PropertySimple simpleProperty = 3;
    optional PropertyCumulative cumulativeProperty = 4;
    optional PropertyFinancial financialProperty = 5;
    optional PropertyIndicator indicatorProperty = 6;
    optional PropertyFeatured featuredProperty = 7;
    optional PropertyBroker brokerProperty = 8;
    optional PropertyOption optionProperty = 9;
    optional PropertyKlineShape klineShapeProperty = 10;
}

message C2S
{
    repeated ScreenQuery filterList = 1;
    repeated RetrieveQuery retrieveList = 2;
    repeated int64 watchlistStockIds = 3;
    optional Sort sort = 4;             // 单字段排序
    optional int32 pageFrom = 5;
    optional int32 pageCount = 6;
    repeated Sort sortList = 7;         // 多字段排序，非空时优先于 sort
}

message Request
{
    required C2S c2s = 1;
}

• 返回

// 单条结果值: valueType=1 时取 sval, =2 取 ival, =3 取 aval, =4 取 dval
message ResultPropertyBasic
{
    required PropertyBasic property = 1;
    optional int32 valueType = 2;
    optional string sval = 3;
    optional int64 ival = 4;
    repeated int64 aval = 5;
    optional double dval = 6;
    optional string enumTypeName = 7;
    optional string enumName = 8;
}
// 其余 ResultPropertySimple / Cumulative / Financial / Indicator / Featured / Broker / Option / KlineShape
// 结构与 ResultPropertyBasic 相同，仅 property 类型不同。Financial 额外包含 endTime。

message RspItemResult
{
    optional ResultPropertyBasic basicPropertyResult = 1;
    optional ResultPropertySimple simplePropertyResult = 2;
    optional ResultPropertyCumulative cumulativePropertyResult = 3;
    optional ResultPropertyFinancial financialPropertyResult = 4;
    optional ResultPropertyIndicator indicatorPropertyResult = 5;
    optional ResultPropertyFeatured featuredPropertyResult = 6;
    optional ResultPropertyBroker brokerPropertyResult = 7;
    optional ResultPropertyOption optionPropertyResult = 8;
    optional ResultPropertyKlineShape klineShapePropertyResult = 9;
}

message RspItem
{
    required int64 stockId = 1;
    repeated RspItemResult results = 2;
}

message S2C
{
    required bool lastPage = 1;
    required int32 allCount = 2;
    repeated RspItem dataList = 3;
}

message Response
{
    required int32 retType = 1 [default = -400];
    optional string retMsg = 2;
    optional int32 errCode = 3;
    optional S2C s2c = 4;
}

• 接口调用结果，结构参见 RetType

• 协议 ID

  3252

uint StockScreen(QotStockScreen.Request req); virtual void OnReply_StockScreen(FTAPI_Conn client, uint nSerialNo, QotStockScreen.Response rsp);

• 介绍

  条件选股 V2

• 参数

message Boundary
{
    required double value = 1;
    optional bool includes = 2;     // 是否闭区间，默认 true
}

message Interval
{
    optional Boundary filterMin = 1;
    optional Boundary filterMax = 2;
}

// ===== 各类 PropertyXxx =====
message PropertyBasic         { required int32 name = 1; }
message PropertySimple        { required int32 name = 1; optional int32 unit = 2; }
message PropertyCumulative    {
    required int32 name = 1;
    required int32 days = 2;
    optional int32 periodAverage = 3;
    optional int32 unit = 4;
}
message PropertyFinancial     {
    required int32 name = 1;
    optional int32 term = 2;
    optional int32 year = 3;
    optional int32 duration = 4;
    optional int32 periodAverage = 5;
    optional int32 futureDuration = 6;
    optional int32 unit = 7;
}
message PropertyIndicator     {
    required int32 name = 1;
    optional int32 period = 2;
    repeated int32 indicatorParams = 3;
}
message PropertyFeatured      {
    required int32 name = 1;
    optional int32 period = 2;
    optional int32 rangePeriod = 3;
    optional int32 firstCustomParam = 4;
}
message PropertyBroker        {
    required int32 name = 1;
    optional int32 days = 2;
    optional string param = 3;
}
message PropertyOption        {
    required int32 name = 1;
    optional int32 period = 2;
    optional string param = 3;
}
message PropertyKlineShape    {
    required int32 name = 1;
    optional int32 period = 2;
}

// ===== 各类 QueryXxx =====
message SimpleFieldQuery
{
    required int32 simpleField = 1;
    repeated int32 screenValueList = 2;
}

message PlateInfo
{
    repeated string plateIdList = 1;
    optional string parentPlateId = 2;
}

message PlateQuery       { repeated PlateInfo plateList = 1; }

message SimplePropertyQuery
{
    required PropertySimple property = 1;
    optional Boundary filterMin = 2;
    optional Boundary filterMax = 3;
}

message CumulativePropertyQuery
{
    required PropertyCumulative property = 1;
    optional Boundary filterMin = 2;
    optional Boundary filterMax = 3;
    optional int32 continuousPeriod = 4;
}

message FinancialPropertyQuery
{
    required PropertyFinancial property = 1;
    optional Boundary filterMin = 2;
    optional Boundary filterMax = 3;
    optional int32 continuousPeriod = 4;
}

message IndicatorPositionalQuery
{
    required int32 firstIndicatorName = 1;
    required int32 periodType = 2;
    required int32 position = 3;
    optional int32 secondIndicator = 4;
    optional int32 secondValue = 5;
    repeated int32 firstIndicatorParams = 6;
    repeated int32 secondIndicatorParams = 7;
    optional int32 continuousPeriod = 8;
    repeated Interval intervals = 9;
}

message IndicatorPatternQuery
{
    required int32 name = 1;
    required int32 periodType = 2;
    optional int32 continuousPeriod = 3;
    optional bool isMatching = 4;
    repeated int32 subPatterns = 5;
}

message FeaturedPropertyQuery
{
    required PropertyFeatured property = 1;
    repeated Interval intervals = 2;
    repeated int32 valueSet = 3;
}

message BrokerHoldingsQuery
{
    required PropertyBroker property = 1;
    repeated Interval intervals = 2;
}

message KlineShapeQuery
{
    required PropertyKlineShape property = 1;
    repeated int32 valueSet = 2;
}

message OptionQuery
{
    required PropertyOption property = 1;
    repeated Interval intervals = 2;
}

// ===== 一条筛选条件 (oneof 多选一) =====
message ScreenQuery
{
    optional SimpleFieldQuery simpleFieldQuery = 1;
    optional PlateQuery plateQuery = 2;
    optional SimplePropertyQuery simplePropertyQuery = 3;
    optional CumulativePropertyQuery cumulativePropertyQuery = 4;
    optional FinancialPropertyQuery financialPropertyQuery = 5;
    optional IndicatorPositionalQuery indicatorPositionalQuery = 6;
    optional IndicatorPatternQuery indicatorPatternQuery = 7;
    optional FeaturedPropertyQuery featuredPropertyQuery = 8;
    optional BrokerHoldingsQuery brokerHoldingsQuery = 9;
    optional KlineShapeQuery klineShapeQuery = 10;
    optional OptionQuery optionQuery = 11;
}

// ===== 取回字段 =====
message RetrieveQuery
{
    optional PropertyBasic basicProperty = 1;
    optional PropertySimple simpleProperty = 2;
    optional PropertyCumulative cumulativeProperty = 3;
    optional PropertyFinancial financialProperty = 4;
    optional PropertyIndicator indicatorProperty = 5;
    optional PropertyFeatured featuredProperty = 6;
    optional PropertyBroker brokerProperty = 7;
    optional PropertyOption optionProperty = 8;
    optional PropertyKlineShape klineShapeProperty = 9;
}

// ===== 排序定义 =====
message Sort
{
    required int32 direction = 1;   // 1=ASC, 2=DESC, 3=ABS_ASC, 4=ABS_DESC
    optional PropertyBasic basicProperty = 2;
    optional PropertySimple simpleProperty = 3;
    optional PropertyCumulative cumulativeProperty = 4;
    optional PropertyFinancial financialProperty = 5;
    optional PropertyIndicator indicatorProperty = 6;
    optional PropertyFeatured featuredProperty = 7;
    optional PropertyBroker brokerProperty = 8;
    optional PropertyOption optionProperty = 9;
    optional PropertyKlineShape klineShapeProperty = 10;
}

message C2S
{
    repeated ScreenQuery filterList = 1;
    repeated RetrieveQuery retrieveList = 2;
    repeated int64 watchlistStockIds = 3;
    optional Sort sort = 4;             // 单字段排序
    optional int32 pageFrom = 5;
    optional int32 pageCount = 6;
    repeated Sort sortList = 7;         // 多字段排序，非空时优先于 sort
}

message Request
{
    required C2S c2s = 1;
}

• 返回

// 单条结果值: valueType=1 时取 sval, =2 取 ival, =3 取 aval, =4 取 dval
message ResultPropertyBasic
{
    required PropertyBasic property = 1;
    optional int32 valueType = 2;
    optional string sval = 3;
    optional int64 ival = 4;
    repeated int64 aval = 5;
    optional double dval = 6;
    optional string enumTypeName = 7;
    optional string enumName = 8;
}
// 其余 ResultPropertySimple / Cumulative / Financial / Indicator / Featured / Broker / Option / KlineShape
// 结构与 ResultPropertyBasic 相同，仅 property 类型不同。Financial 额外包含 endTime。

message RspItemResult
{
    optional ResultPropertyBasic basicPropertyResult = 1;
    optional ResultPropertySimple simplePropertyResult = 2;
    optional ResultPropertyCumulative cumulativePropertyResult = 3;
    optional ResultPropertyFinancial financialPropertyResult = 4;
    optional ResultPropertyIndicator indicatorPropertyResult = 5;
    optional ResultPropertyFeatured featuredPropertyResult = 6;
    optional ResultPropertyBroker brokerPropertyResult = 7;
    optional ResultPropertyOption optionPropertyResult = 8;
    optional ResultPropertyKlineShape klineShapePropertyResult = 9;
}

message RspItem
{
    required int64 stockId = 1;
    repeated RspItemResult results = 2;
}

message S2C
{
    required bool lastPage = 1;
    required int32 allCount = 2;
    repeated RspItem dataList = 3;
}

message Response
{
    required int32 retType = 1 [default = -400];
    optional string retMsg = 2;
    optional int32 errCode = 3;
    optional S2C s2c = 4;
}

• 接口调用结果，结构参见 RetType

• 协议 ID

  3252

int stockScreen(QotStockScreen.Request req) onReply_StockScreen(FTAPI_Conn client, int nSerialNo, QotStockScreen.Response rsp)

• 介绍

  条件选股 V2

• 参数

message Boundary
{
    required double value = 1;
    optional bool includes = 2;     // 是否闭区间，默认 true
}

message Interval
{
    optional Boundary filterMin = 1;
    optional Boundary filterMax = 2;
}

// ===== 各类 PropertyXxx =====
message PropertyBasic         { required int32 name = 1; }
message PropertySimple        { required int32 name = 1; optional int32 unit = 2; }
message PropertyCumulative    {
    required int32 name = 1;
    required int32 days = 2;
    optional int32 periodAverage = 3;
    optional int32 unit = 4;
}
message PropertyFinancial     {
    required int32 name = 1;
    optional int32 term = 2;
    optional int32 year = 3;
    optional int32 duration = 4;
    optional int32 periodAverage = 5;
    optional int32 futureDuration = 6;
    optional int32 unit = 7;
}
message PropertyIndicator     {
    required int32 name = 1;
    optional int32 period = 2;
    repeated int32 indicatorParams = 3;
}
message PropertyFeatured      {
    required int32 name = 1;
    optional int32 period = 2;
    optional int32 rangePeriod = 3;
    optional int32 firstCustomParam = 4;
}
message PropertyBroker        {
    required int32 name = 1;
    optional int32 days = 2;
    optional string param = 3;
}
message PropertyOption        {
    required int32 name = 1;
    optional int32 period = 2;
    optional string param = 3;
}
message PropertyKlineShape    {
    required int32 name = 1;
    optional int32 period = 2;
}

// ===== 各类 QueryXxx =====
message SimpleFieldQuery
{
    required int32 simpleField = 1;
    repeated int32 screenValueList = 2;
}

message PlateInfo
{
    repeated string plateIdList = 1;
    optional string parentPlateId = 2;
}

message PlateQuery       { repeated PlateInfo plateList = 1; }

message SimplePropertyQuery
{
    required PropertySimple property = 1;
    optional Boundary filterMin = 2;
    optional Boundary filterMax = 3;
}

message CumulativePropertyQuery
{
    required PropertyCumulative property = 1;
    optional Boundary filterMin = 2;
    optional Boundary filterMax = 3;
    optional int32 continuousPeriod = 4;
}

message FinancialPropertyQuery
{
    required PropertyFinancial property = 1;
    optional Boundary filterMin = 2;
    optional Boundary filterMax = 3;
    optional int32 continuousPeriod = 4;
}

message IndicatorPositionalQuery
{
    required int32 firstIndicatorName = 1;
    required int32 periodType = 2;
    required int32 position = 3;
    optional int32 secondIndicator = 4;
    optional int32 secondValue = 5;
    repeated int32 firstIndicatorParams = 6;
    repeated int32 secondIndicatorParams = 7;
    optional int32 continuousPeriod = 8;
    repeated Interval intervals = 9;
}

message IndicatorPatternQuery
{
    required int32 name = 1;
    required int32 periodType = 2;
    optional int32 continuousPeriod = 3;
    optional bool isMatching = 4;
    repeated int32 subPatterns = 5;
}

message FeaturedPropertyQuery
{
    required PropertyFeatured property = 1;
    repeated Interval intervals = 2;
    repeated int32 valueSet = 3;
}

message BrokerHoldingsQuery
{
    required PropertyBroker property = 1;
    repeated Interval intervals = 2;
}

message KlineShapeQuery
{
    required PropertyKlineShape property = 1;
    repeated int32 valueSet = 2;
}

message OptionQuery
{
    required PropertyOption property = 1;
    repeated Interval intervals = 2;
}

// ===== 一条筛选条件 (oneof 多选一) =====
message ScreenQuery
{
    optional SimpleFieldQuery simpleFieldQuery = 1;
    optional PlateQuery plateQuery = 2;
    optional SimplePropertyQuery simplePropertyQuery = 3;
    optional CumulativePropertyQuery cumulativePropertyQuery = 4;
    optional FinancialPropertyQuery financialPropertyQuery = 5;
    optional IndicatorPositionalQuery indicatorPositionalQuery = 6;
    optional IndicatorPatternQuery indicatorPatternQuery = 7;
    optional FeaturedPropertyQuery featuredPropertyQuery = 8;
    optional BrokerHoldingsQuery brokerHoldingsQuery = 9;
    optional KlineShapeQuery klineShapeQuery = 10;
    optional OptionQuery optionQuery = 11;
}

// ===== 取回字段 =====
message RetrieveQuery
{
    optional PropertyBasic basicProperty = 1;
    optional PropertySimple simpleProperty = 2;
    optional PropertyCumulative cumulativeProperty = 3;
    optional PropertyFinancial financialProperty = 4;
    optional PropertyIndicator indicatorProperty = 5;
    optional PropertyFeatured featuredProperty = 6;
    optional PropertyBroker brokerProperty = 7;
    optional PropertyOption optionProperty = 8;
    optional PropertyKlineShape klineShapeProperty = 9;
}

// ===== 排序定义 =====
message Sort
{
    required int32 direction = 1;   // 1=ASC, 2=DESC, 3=ABS_ASC, 4=ABS_DESC
    optional PropertyBasic basicProperty = 2;
    optional PropertySimple simpleProperty = 3;
    optional PropertyCumulative cumulativeProperty = 4;
    optional PropertyFinancial financialProperty = 5;
    optional PropertyIndicator indicatorProperty = 6;
    optional PropertyFeatured featuredProperty = 7;
    optional PropertyBroker brokerProperty = 8;
    optional PropertyOption optionProperty = 9;
    optional PropertyKlineShape klineShapeProperty = 10;
}

message C2S
{
    repeated ScreenQuery filterList = 1;
    repeated RetrieveQuery retrieveList = 2;
    repeated int64 watchlistStockIds = 3;
    optional Sort sort = 4;             // 单字段排序
    optional int32 pageFrom = 5;
    optional int32 pageCount = 6;
    repeated Sort sortList = 7;         // 多字段排序，非空时优先于 sort
}

message Request
{
    required C2S c2s = 1;
}

• 返回

// 单条结果值: valueType=1 时取 sval, =2 取 ival, =3 取 aval, =4 取 dval
message ResultPropertyBasic
{
    required PropertyBasic property = 1;
    optional int32 valueType = 2;
    optional string sval = 3;
    optional int64 ival = 4;
    repeated int64 aval = 5;
    optional double dval = 6;
    optional string enumTypeName = 7;
    optional string enumName = 8;
}
// 其余 ResultPropertySimple / Cumulative / Financial / Indicator / Featured / Broker / Option / KlineShape
// 结构与 ResultPropertyBasic 相同，仅 property 类型不同。Financial 额外包含 endTime。

message RspItemResult
{
    optional ResultPropertyBasic basicPropertyResult = 1;
    optional ResultPropertySimple simplePropertyResult = 2;
    optional ResultPropertyCumulative cumulativePropertyResult = 3;
    optional ResultPropertyFinancial financialPropertyResult = 4;
    optional ResultPropertyIndicator indicatorPropertyResult = 5;
    optional ResultPropertyFeatured featuredPropertyResult = 6;
    optional ResultPropertyBroker brokerPropertyResult = 7;
    optional ResultPropertyOption optionPropertyResult = 8;
    optional ResultPropertyKlineShape klineShapePropertyResult = 9;
}

message RspItem
{
    required int64 stockId = 1;
    repeated RspItemResult results = 2;
}

message S2C
{
    required bool lastPage = 1;
    required int32 allCount = 2;
    repeated RspItem dataList = 3;
}

message Response
{
    required int32 retType = 1 [default = -400];
    optional string retMsg = 2;
    optional int32 errCode = 3;
    optional S2C s2c = 4;
}

• 接口调用结果，结构参见 RetType

• 协议 ID

  3252

bool StockScreen(uint32_t & nSerialNo, const Qot_StockScreen::Request & stReq); virtual void OnReply_StockScreen(FTAPI_Conn* pConn, uint32_t nSerialNo, const Qot_StockScreen::Response & stRsp)

• 介绍

  条件选股 V2

• 参数

message Boundary
{
    required double value = 1;
    optional bool includes = 2;     // 是否闭区间，默认 true
}

message Interval
{
    optional Boundary filterMin = 1;
    optional Boundary filterMax = 2;
}

// ===== 各类 PropertyXxx =====
message PropertyBasic         { required int32 name = 1; }
message PropertySimple        { required int32 name = 1; optional int32 unit = 2; }
message PropertyCumulative    {
    required int32 name = 1;
    required int32 days = 2;
    optional int32 periodAverage = 3;
    optional int32 unit = 4;
}
message PropertyFinancial     {
    required int32 name = 1;
    optional int32 term = 2;
    optional int32 year = 3;
    optional int32 duration = 4;
    optional int32 periodAverage = 5;
    optional int32 futureDuration = 6;
    optional int32 unit = 7;
}
message PropertyIndicator     {
    required int32 name = 1;
    optional int32 period = 2;
    repeated int32 indicatorParams = 3;
}
message PropertyFeatured      {
    required int32 name = 1;
    optional int32 period = 2;
    optional int32 rangePeriod = 3;
    optional int32 firstCustomParam = 4;
}
message PropertyBroker        {
    required int32 name = 1;
    optional int32 days = 2;
    optional string param = 3;
}
message PropertyOption        {
    required int32 name = 1;
    optional int32 period = 2;
    optional string param = 3;
}
message PropertyKlineShape    {
    required int32 name = 1;
    optional int32 period = 2;
}

// ===== 各类 QueryXxx =====
message SimpleFieldQuery
{
    required int32 simpleField = 1;
    repeated int32 screenValueList = 2;
}

message PlateInfo
{
    repeated string plateIdList = 1;
    optional string parentPlateId = 2;
}

message PlateQuery       { repeated PlateInfo plateList = 1; }

message SimplePropertyQuery
{
    required PropertySimple property = 1;
    optional Boundary filterMin = 2;
    optional Boundary filterMax = 3;
}

message CumulativePropertyQuery
{
    required PropertyCumulative property = 1;
    optional Boundary filterMin = 2;
    optional Boundary filterMax = 3;
    optional int32 continuousPeriod = 4;
}

message FinancialPropertyQuery
{
    required PropertyFinancial property = 1;
    optional Boundary filterMin = 2;
    optional Boundary filterMax = 3;
    optional int32 continuousPeriod = 4;
}

message IndicatorPositionalQuery
{
    required int32 firstIndicatorName = 1;
    required int32 periodType = 2;
    required int32 position = 3;
    optional int32 secondIndicator = 4;
    optional int32 secondValue = 5;
    repeated int32 firstIndicatorParams = 6;
    repeated int32 secondIndicatorParams = 7;
    optional int32 continuousPeriod = 8;
    repeated Interval intervals = 9;
}

message IndicatorPatternQuery
{
    required int32 name = 1;
    required int32 periodType = 2;
    optional int32 continuousPeriod = 3;
    optional bool isMatching = 4;
    repeated int32 subPatterns = 5;
}

message FeaturedPropertyQuery
{
    required PropertyFeatured property = 1;
    repeated Interval intervals = 2;
    repeated int32 valueSet = 3;
}

message BrokerHoldingsQuery
{
    required PropertyBroker property = 1;
    repeated Interval intervals = 2;
}

message KlineShapeQuery
{
    required PropertyKlineShape property = 1;
    repeated int32 valueSet = 2;
}

message OptionQuery
{
    required PropertyOption property = 1;
    repeated Interval intervals = 2;
}

// ===== 一条筛选条件 (oneof 多选一) =====
message ScreenQuery
{
    optional SimpleFieldQuery simpleFieldQuery = 1;
    optional PlateQuery plateQuery = 2;
    optional SimplePropertyQuery simplePropertyQuery = 3;
    optional CumulativePropertyQuery cumulativePropertyQuery = 4;
    optional FinancialPropertyQuery financialPropertyQuery = 5;
    optional IndicatorPositionalQuery indicatorPositionalQuery = 6;
    optional IndicatorPatternQuery indicatorPatternQuery = 7;
    optional FeaturedPropertyQuery featuredPropertyQuery = 8;
    optional BrokerHoldingsQuery brokerHoldingsQuery = 9;
    optional KlineShapeQuery klineShapeQuery = 10;
    optional OptionQuery optionQuery = 11;
}

// ===== 取回字段 =====
message RetrieveQuery
{
    optional PropertyBasic basicProperty = 1;
    optional PropertySimple simpleProperty = 2;
    optional PropertyCumulative cumulativeProperty = 3;
    optional PropertyFinancial financialProperty = 4;
    optional PropertyIndicator indicatorProperty = 5;
    optional PropertyFeatured featuredProperty = 6;
    optional PropertyBroker brokerProperty = 7;
    optional PropertyOption optionProperty = 8;
    optional PropertyKlineShape klineShapeProperty = 9;
}

// ===== 排序定义 =====
message Sort
{
    required int32 direction = 1;   // 1=ASC, 2=DESC, 3=ABS_ASC, 4=ABS_DESC
    optional PropertyBasic basicProperty = 2;
    optional PropertySimple simpleProperty = 3;
    optional PropertyCumulative cumulativeProperty = 4;
    optional PropertyFinancial financialProperty = 5;
    optional PropertyIndicator indicatorProperty = 6;
    optional PropertyFeatured featuredProperty = 7;
    optional PropertyBroker brokerProperty = 8;
    optional PropertyOption optionProperty = 9;
    optional PropertyKlineShape klineShapeProperty = 10;
}

message C2S
{
    repeated ScreenQuery filterList = 1;
    repeated RetrieveQuery retrieveList = 2;
    repeated int64 watchlistStockIds = 3;
    optional Sort sort = 4;             // 单字段排序
    optional int32 pageFrom = 5;
    optional int32 pageCount = 6;
    repeated Sort sortList = 7;         // 多字段排序，非空时优先于 sort
}

message Request
{
    required C2S c2s = 1;
}

• 返回

// 单条结果值: valueType=1 时取 sval, =2 取 ival, =3 取 aval, =4 取 dval
message ResultPropertyBasic
{
    required PropertyBasic property = 1;
    optional int32 valueType = 2;
    optional string sval = 3;
    optional int64 ival = 4;
    repeated int64 aval = 5;
    optional double dval = 6;
    optional string enumTypeName = 7;
    optional string enumName = 8;
}
// 其余 ResultPropertySimple / Cumulative / Financial / Indicator / Featured / Broker / Option / KlineShape
// 结构与 ResultPropertyBasic 相同，仅 property 类型不同。Financial 额外包含 endTime。

message RspItemResult
{
    optional ResultPropertyBasic basicPropertyResult = 1;
    optional ResultPropertySimple simplePropertyResult = 2;
    optional ResultPropertyCumulative cumulativePropertyResult = 3;
    optional ResultPropertyFinancial financialPropertyResult = 4;
    optional ResultPropertyIndicator indicatorPropertyResult = 5;
    optional ResultPropertyFeatured featuredPropertyResult = 6;
    optional ResultPropertyBroker brokerPropertyResult = 7;
    optional ResultPropertyOption optionPropertyResult = 8;
    optional ResultPropertyKlineShape klineShapePropertyResult = 9;
}

message RspItem
{
    required int64 stockId = 1;
    repeated RspItemResult results = 2;
}

message S2C
{
    required bool lastPage = 1;
    required int32 allCount = 2;
    repeated RspItem dataList = 3;
}

message Response
{
    required int32 retType = 1 [default = -400];
    optional string retMsg = 2;
    optional int32 errCode = 3;
    optional S2C s2c = 4;
}

• 接口调用结果，结构参见 RetType

• 协议 ID

  3252

GetStockScreen(req);

• 介绍

  条件选股 V2

• 参数

message Boundary
{
    required double value = 1;
    optional bool includes = 2;     // 是否闭区间，默认 true
}

message Interval
{
    optional Boundary filterMin = 1;
    optional Boundary filterMax = 2;
}

// ===== 各类 PropertyXxx =====
message PropertyBasic         { required int32 name = 1; }
message PropertySimple        { required int32 name = 1; optional int32 unit = 2; }
message PropertyCumulative    {
    required int32 name = 1;
    required int32 days = 2;
    optional int32 periodAverage = 3;
    optional int32 unit = 4;
}
message PropertyFinancial     {
    required int32 name = 1;
    optional int32 term = 2;
    optional int32 year = 3;
    optional int32 duration = 4;
    optional int32 periodAverage = 5;
    optional int32 futureDuration = 6;
    optional int32 unit = 7;
}
message PropertyIndicator     {
    required int32 name = 1;
    optional int32 period = 2;
    repeated int32 indicatorParams = 3;
}
message PropertyFeatured      {
    required int32 name = 1;
    optional int32 period = 2;
    optional int32 rangePeriod = 3;
    optional int32 firstCustomParam = 4;
}
message PropertyBroker        {
    required int32 name = 1;
    optional int32 days = 2;
    optional string param = 3;
}
message PropertyOption        {
    required int32 name = 1;
    optional int32 period = 2;
    optional string param = 3;
}
message PropertyKlineShape    {
    required int32 name = 1;
    optional int32 period = 2;
}

// ===== 各类 QueryXxx =====
message SimpleFieldQuery
{
    required int32 simpleField = 1;
    repeated int32 screenValueList = 2;
}

message PlateInfo
{
    repeated string plateIdList = 1;
    optional string parentPlateId = 2;
}

message PlateQuery       { repeated PlateInfo plateList = 1; }

message SimplePropertyQuery
{
    required PropertySimple property = 1;
    optional Boundary filterMin = 2;
    optional Boundary filterMax = 3;
}

message CumulativePropertyQuery
{
    required PropertyCumulative property = 1;
    optional Boundary filterMin = 2;
    optional Boundary filterMax = 3;
    optional int32 continuousPeriod = 4;
}

message FinancialPropertyQuery
{
    required PropertyFinancial property = 1;
    optional Boundary filterMin = 2;
    optional Boundary filterMax = 3;
    optional int32 continuousPeriod = 4;
}

message IndicatorPositionalQuery
{
    required int32 firstIndicatorName = 1;
    required int32 periodType = 2;
    required int32 position = 3;
    optional int32 secondIndicator = 4;
    optional int32 secondValue = 5;
    repeated int32 firstIndicatorParams = 6;
    repeated int32 secondIndicatorParams = 7;
    optional int32 continuousPeriod = 8;
    repeated Interval intervals = 9;
}

message IndicatorPatternQuery
{
    required int32 name = 1;
    required int32 periodType = 2;
    optional int32 continuousPeriod = 3;
    optional bool isMatching = 4;
    repeated int32 subPatterns = 5;
}

message FeaturedPropertyQuery
{
    required PropertyFeatured property = 1;
    repeated Interval intervals = 2;
    repeated int32 valueSet = 3;
}

message BrokerHoldingsQuery
{
    required PropertyBroker property = 1;
    repeated Interval intervals = 2;
}

message KlineShapeQuery
{
    required PropertyKlineShape property = 1;
    repeated int32 valueSet = 2;
}

message OptionQuery
{
    required PropertyOption property = 1;
    repeated Interval intervals = 2;
}

// ===== 一条筛选条件 (oneof 多选一) =====
message ScreenQuery
{
    optional SimpleFieldQuery simpleFieldQuery = 1;
    optional PlateQuery plateQuery = 2;
    optional SimplePropertyQuery simplePropertyQuery = 3;
    optional CumulativePropertyQuery cumulativePropertyQuery = 4;
    optional FinancialPropertyQuery financialPropertyQuery = 5;
    optional IndicatorPositionalQuery indicatorPositionalQuery = 6;
    optional IndicatorPatternQuery indicatorPatternQuery = 7;
    optional FeaturedPropertyQuery featuredPropertyQuery = 8;
    optional BrokerHoldingsQuery brokerHoldingsQuery = 9;
    optional KlineShapeQuery klineShapeQuery = 10;
    optional OptionQuery optionQuery = 11;
}

// ===== 取回字段 =====
message RetrieveQuery
{
    optional PropertyBasic basicProperty = 1;
    optional PropertySimple simpleProperty = 2;
    optional PropertyCumulative cumulativeProperty = 3;
    optional PropertyFinancial financialProperty = 4;
    optional PropertyIndicator indicatorProperty = 5;
    optional PropertyFeatured featuredProperty = 6;
    optional PropertyBroker brokerProperty = 7;
    optional PropertyOption optionProperty = 8;
    optional PropertyKlineShape klineShapeProperty = 9;
}

// ===== 排序定义 =====
message Sort
{
    required int32 direction = 1;   // 1=ASC, 2=DESC, 3=ABS_ASC, 4=ABS_DESC
    optional PropertyBasic basicProperty = 2;
    optional PropertySimple simpleProperty = 3;
    optional PropertyCumulative cumulativeProperty = 4;
    optional PropertyFinancial financialProperty = 5;
    optional PropertyIndicator indicatorProperty = 6;
    optional PropertyFeatured featuredProperty = 7;
    optional PropertyBroker brokerProperty = 8;
    optional PropertyOption optionProperty = 9;
    optional PropertyKlineShape klineShapeProperty = 10;
}

message C2S
{
    repeated ScreenQuery filterList = 1;
    repeated RetrieveQuery retrieveList = 2;
    repeated int64 watchlistStockIds = 3;
    optional Sort sort = 4;             // 单字段排序
    optional int32 pageFrom = 5;
    optional int32 pageCount = 6;
    repeated Sort sortList = 7;         // 多字段排序，非空时优先于 sort
}

message Request
{
    required C2S c2s = 1;
}

• 返回

// 单条结果值: valueType=1 时取 sval, =2 取 ival, =3 取 aval, =4 取 dval
message ResultPropertyBasic
{
    required PropertyBasic property = 1;
    optional int32 valueType = 2;
    optional string sval = 3;
    optional int64 ival = 4;
    repeated int64 aval = 5;
    optional double dval = 6;
    optional string enumTypeName = 7;
    optional string enumName = 8;
}
// 其余 ResultPropertySimple / Cumulative / Financial / Indicator / Featured / Broker / Option / KlineShape
// 结构与 ResultPropertyBasic 相同，仅 property 类型不同。Financial 额外包含 endTime。

message RspItemResult
{
    optional ResultPropertyBasic basicPropertyResult = 1;
    optional ResultPropertySimple simplePropertyResult = 2;
    optional ResultPropertyCumulative cumulativePropertyResult = 3;
    optional ResultPropertyFinancial financialPropertyResult = 4;
    optional ResultPropertyIndicator indicatorPropertyResult = 5;
    optional ResultPropertyFeatured featuredPropertyResult = 6;
    optional ResultPropertyBroker brokerPropertyResult = 7;
    optional ResultPropertyOption optionPropertyResult = 8;
    optional ResultPropertyKlineShape klineShapePropertyResult = 9;
}

message RspItem
{
    required int64 stockId = 1;
    repeated RspItemResult results = 2;
}

message S2C
{
    required bool lastPage = 1;
    required int32 allCount = 2;
    repeated RspItem dataList = 3;
}

message Response
{
    required int32 retType = 1 [default = -400];
    optional string retMsg = 2;
    optional int32 errCode = 3;
    optional S2C s2c = 4;
}

• 接口调用结果，结构参见 RetType

• 协议 ID

  3252

• Example

import ftWebsocket from "futu-api";
import { Common, Qot_Common } from "futu-api/proto";
import beautify from "js-beautify";

function QotGetStockScreen(){
    const { RetType } = Common
    // SimpleField / ScrMarket / SimpleProperty 为数值常量，完整列表见 quote.md「筛选 V2」；下同
    let [addr, port, enable_ssl, key] = ["127.0.0.1", 33333, false, '7522027ccf5a06b1'];
    let websocket = new ftWebsocket();

    websocket.onlogin = (ret, msg)=>{
        if (ret) {
            // 港股最新价 >= 10、市值 >= 100 亿，按市值降序取回代码/名称/价格/市值
            const req = {
                c2s: {
                    filterList: [
                        { simpleFieldQuery: { simpleField: 1 /* SimpleField.MARKET 市场 */, screenValueList: [1 /* ScrMarket.HK */] } },
                        { simplePropertyQuery: { property: { name: 2201 /* SimpleProperty.PRICE */ }, filterMin: { value: 10, includes: true } } },
                        { simplePropertyQuery: { property: { name: 2301 /* SimpleProperty.MARKET_CAP */ }, filterMin: { value: 10000000000, includes: true } } }
                    ],
                    retrieveList: [
                        { basicProperty: { name: 1101 } },
                        { basicProperty: { name: 1102 } },
                        { simpleProperty: { name: 2201 /* SimpleProperty.PRICE */ } },
                        { simpleProperty: { name: 2301 /* SimpleProperty.MARKET_CAP */ } }
                    ],
                    sort: { direction: 2, simpleProperty: { name: 2301 /* SimpleProperty.MARKET_CAP */ } },
                    pageFrom: 0,
                    pageCount: 5,
                },
            };
            websocket.GetStockScreen(req)
            .then((res)=>{
                let { errCode, retMsg, retType, s2c } = res
                console.log("GetStockScreen: errCode %d, retMsg %s, retType %d", errCode, retMsg, retType);
                if(retType == RetType.RetType_Succeed){
                    let data = beautify(JSON.stringify(s2c), { indent_size: 2, space_in_empty_paren: true });
                    console.log(data);
                }
            })
            .catch((error)=>{ console.log("error:", error); });
        } else {
            console.log("start error", msg);
        }
    };

    websocket.start(addr, port, enable_ssl, key);
    setTimeout(()=>{ websocket.stop(); process.exit(); }, 5000);
}

QotGetStockScreen()

• Output

GetStockScreen: errCode 0, retMsg , retType 0
{
  "lastPage": true,
  "allCount": 1,
  "dataList": [
    {
      "stockId": "54047868453564",
      "results": [
        { "basicPropertyResult": { "property": { "name": 1101 }, "valueType": 1, "sval": "00700" } },
        { "basicPropertyResult": { "property": { "name": 1102 }, "valueType": 1, "sval": "腾讯控股" } },
        { "simplePropertyResult": { "property": { "name": 2201 }, "valueType": 4, "dval": 460.0 } },
        { "simplePropertyResult": { "property": { "name": 2301 }, "valueType": 4, "dval": 4194280264040.0 } }
      ]
    }
  ]
}

接口限制

• 每 30 秒内最多请求 10 次条件选股接口

• Python
• Proto
• C#
• Java
• C++
• JavaScript

get_stock_screen(request)

• 介绍

  条件选股 V2。相比旧接口 get_stock_filter，因子覆盖更广（11 类共 244+ 个因子），数值统一传原始值（OpenD 自动倍率转换），支持单字段或多字段排序、显式声明取回属性，结果按 value_type 分别填入 sval / ival / aval / dval。

• 参数

  参数	类型	说明
  request	StockScreenRequest	条件选股请求对象，通过 builder 方式构建

  • StockScreenRequest 字段：

    字段	类型	说明
    page_from	int	分页起始位置 不传默认为 0
    page_count	int	单页最大返回数 不传默认为 200

  • 筛选条件 builder 方法（每次调用追加一条筛选条件，所有数值字段直接传原始值，OpenD 自动倍率转换）：

    方法	说明
    add_simple_field(field, values)	市场 / 交易所 / 指数 / 自选股等枚举字段筛选 field 取自 SimpleField；values 为枚举值列表（OR 关系）。ScrMarket.MY / JP / SG 后续支持，目前结果为空
    add_plate(plate_ids, parent_plate_id=None)	板块筛选 plate_ids 形如 ["BK1001"]
    add_simple_property(name, lower=None, upper=None)	简单行情属性区间筛选 name 取自 SimpleProperty（最新价、市值、PE、量比等）；lower / upper 直接传原始值，如最新价 10 元传 10、市值 ≥ 100 亿传 10_000_000_000
    add_cumulative_property(name, days=1, lower=None, upper=None)	累计行情属性 name 取自 CumulativeProperty；days 用于 N 日累计。涨跌幅类（如 PRICE_CHANGE_PCT）传值为小数（5% 传 0.05，非 5.0）
    add_financial_property(name, term=None, year=None, lower=None, upper=None, ...)	财务属性 name 取自 FinancialProperty；term 取自 Term 枚举（Q1=1、年报=100、最新单季=10 等）。Term.SURPRISE_LATEST 系列（200~204）实测 HK/US 均会返回数值，但当前数据通常与 ANNUAL 相同，慎用
    add_indicator_positional(first_indicator_name, period_type, position, second_indicator=None, ...)	技术指标位置关系 如 MA5 上穿 MA20。指标名/周期/位置取自 Indicator / Period / Position
    add_indicator_pattern(name, period_type, ...)	技术指标形态（金叉、死叉、背离等） name 取自 Pattern
    add_featured_property(name, intervals=None, value_set=None, period=None, range_period=None, first_custom_param=None)	特色指标（筹码、热度、分析师评级、资金流等）
    add_broker_holdings(name, days=None, param=None, intervals=None)	经纪商持股因子 仅港股。经纪商因子 6101 / 6102 / 6105 / 6106 / 6107 倍率 1000，按百分数传值（如 20% 传 20）；days 参数不生效
    add_kline_shape(name, period=None, value_set=None)	K 线形态（双底、头肩底等） period 必传，目前仅支持日 K(11) 与 1 小时 K(21)
    add_option(name, intervals=None, param=None, period=None)	期权指标（正股 IV、HV 等）

  • 取回属性 builder 方法（声明返回哪些字段值；不声明则只返回 stock_id）：

    方法	说明
    add_retrieve_basic(name)	代码 / 名称 / 行业 name 取自 BasicProperty：CODE=1101、NAME=1102、INDUSTRY=1103
    add_retrieve_simple(name)	简单行情属性 name 取自 SimpleProperty
    add_retrieve_cumulative(name, days=1, period_average=None)	累计属性 name 取自 CumulativeProperty
    add_retrieve_financial(name, term=None, year=None, ...)	财务属性 name 取自 FinancialProperty
    add_retrieve_indicator(name, period=None, indicator_params=None)	技术指标
    add_retrieve_featured(name, period=None, range_period=None, first_custom_param=None)	特色属性
    add_retrieve_broker(name, days=None, param=None)	经纪商
    add_retrieve_option(name, param=None, period=None)	期权属性
    add_retrieve_kline_shape(name, period=None)	K 线形态 period 必传，否则不返回结果；目前仅支持日 K(11) 与 1 小时 K(21)

  • 排序 builder 方法：

    方法	说明
    set_sort(direction, property_type, property_params)	单字段排序 direction 取自 ScrSortDir：ASC=1、DESC=2、ABS_ASC=3、ABS_DESC=4。property_type 取 'basic' / 'simple' / 'cumulative' / 'financial' / 'indicator' / 'featured' / 'broker' / 'option' / 'kline_shape'
    add_sort(direction, property_type, property_params)	多字段排序 按调用顺序生效；与 set_sort 二选一，sortList 非空时优先

• 返回

  参数	类型	说明
  ret	RET_CODE	接口调用结果
  data	tuple	当 ret == RET_OK，返回 (last_page, all_count, items)
  	str	当 ret != RET_OK，返回错误描述

  • 返回 tuple 字段：

    字段	类型	说明
    last_page	bool	是否最后一页
    all_count	int	满足条件的总条数
    items	list[dict]	当前页结果列表，元素结构为 {'stock_id': int, 'results': [result, ...]}

  • 单条 result 结构：

    字段	类型	说明
    type	str	属性类型 'basic' / 'simple' / 'cumulative' / 'financial' / 'indicator' / 'featured' / 'broker' / 'option' / 'kline_shape'
    property	dict	对应 property 描述（含 name / days / term 等）
    value_type	int	值类型 1=string(sval)、2=int64(ival)、3=int64数组(aval)、4=double(dval)。当 OpenD 无数据时仅下发 value_type（多为 2），sval/ival/aval/dval 均缺失，如港股 Q2/Q3/Q4 财务数据
    sval	str	字符串值（value_type=1 时存在）
    ival	int	整型值（value_type=2 时存在）
    aval	list[int]	整型数组值（value_type=3 时存在）
    dval	float	浮点值（value_type=4 时存在）
    enum_type_name	str	当 ival 为枚举码时，对应的枚举类型名（如 'KlineShapeType'）
    enum_name	str	当 ival 为枚举码时，OpenD/SDK 解码出的枚举名（如 'DOUBLE_BOTTOMS'、'NONE'）
    end_time	int	财报结束时间戳 仅 financial 类型，且当前 OpenD 版本暂未下发，实际返回结果中通常没有该字段

• Example

from moomoo import OpenQuoteContext, RET_OK, StockScreenRequest
from moomoo.quote.stock_screen_const import (
    ScrMarket, ScrSortDir, SimpleField, SimpleProperty,
    CumulativeProperty, FinancialProperty, Term,
    Indicator, Period, Position, Pattern,
    BasicProperty, KlineShapeProperty, KlineShapeType,
)

quote_ctx = OpenQuoteContext(host='127.0.0.1', port=11111)

# 示例 1：港股大市值股 + MACD 金叉
req = StockScreenRequest()
req.add_simple_field(field=SimpleField.MARKET, values=[ScrMarket.HK])
req.add_simple_property(name=SimpleProperty.PRICE, lower=10.0)                   # 最新价 ≥ 10
req.add_simple_property(name=SimpleProperty.MARKET_CAP, lower=10_000_000_000.0)  # 市值 ≥ 100 亿
req.add_simple_property(name=SimpleProperty.PE_TTM, lower=10.0, upper=50.0)      # PE(TTM) 10~50
req.add_indicator_pattern(name=Pattern.MACD_GOLD_CROSS, period_type=Period.DAY)  # MACD 金叉
# 取回字段
req.add_retrieve_basic(name=BasicProperty.CODE)
req.add_retrieve_basic(name=BasicProperty.NAME)
req.add_retrieve_simple(name=SimpleProperty.PRICE)
req.add_retrieve_simple(name=SimpleProperty.MARKET_CAP)
req.add_retrieve_simple(name=SimpleProperty.PE_TTM)
# 排序
req.set_sort(direction=ScrSortDir.DESC, property_type='simple',
             property_params={'name': int(SimpleProperty.MARKET_CAP)})
req.page_count = 50

ret, data = quote_ctx.get_stock_screen(req)
if ret == RET_OK:
    last_page, all_count, items = data
    print(f"总数 {all_count}, 当前返回 {len(items)} 条")
    for it in items[:3]:
        print(it['stock_id'], it['results'])
else:
    print('error: ', data)

# 示例 2：财务因子 + 累计涨跌幅
req = StockScreenRequest()
req.add_simple_field(field=SimpleField.MARKET, values=[ScrMarket.HK])
req.add_cumulative_property(name=CumulativeProperty.PRICE_CHANGE_PCT,
                            days=5, lower=-0.05, upper=0.05)                     # 5 日涨跌幅 -5%~5%（百分数传小数）
req.add_financial_property(name=FinancialProperty.NET_PROFIT,
                           term=Term.ANNUAL, lower=0.0)                          # 年报净利润 > 0
req.add_retrieve_basic(name=BasicProperty.CODE)
req.add_retrieve_simple(name=SimpleProperty.PRICE)
req.page_count = 200
ret, data = quote_ctx.get_stock_screen(req)

# 示例 3：K 线形态（W 型底 + 头肩底）
req = StockScreenRequest()
req.add_simple_field(field=SimpleField.MARKET, values=[ScrMarket.HK])
req.add_kline_shape(name=KlineShapeProperty.SHAPE_TYPE, period=Period.DAY,
                    value_set=[KlineShapeType.DOUBLE_BOTTOMS,
                               KlineShapeType.HEAD_SHOULDERS_BOTTOM])
req.add_retrieve_basic(name=BasicProperty.CODE)
req.add_retrieve_kline_shape(name=KlineShapeProperty.SHAPE_TYPE, period=Period.DAY)
ret, data = quote_ctx.get_stock_screen(req)

quote_ctx.close()

• Output

总数 1, 当前返回 1 条
54047868453564 [{'type': 'basic', 'property': {'name': 1101}, 'value_type': 1, 'sval': '00700'},
                {'type': 'basic', 'property': {'name': 1102}, 'value_type': 1, 'sval': '腾讯控股'},
                {'type': 'simple', 'property': {'name': 2201}, 'value_type': 4, 'dval': 460.0},
                {'type': 'simple', 'property': {'name': 2301}, 'value_type': 4, 'dval': 4194280264040.0},
                {'type': 'simple', 'property': {'name': 2303}, 'value_type': 4, 'dval': 15.75126}]

• 字段逐项示例（按类别）

  以下示例均以 HK 市场为例：先 req = StockScreenRequest()，再 req.add_simple_field(field=SimpleField.MARKET, values=[ScrMarket.HK])， 再叠加每段中的筛选 / 取回 / 排序条件，最后 quote_ctx.get_stock_screen(req) 取 (last_page, all_count, items)。 实测的 head 已展开 results 数组里的对应 property 值（code/name 来自 BasicProperty.CODE/NAME，因子列名取自 SDK 字段名小写）。

  简单行情属性 SimpleProperty

  通过 add_simple_property(name, lower, upper) 传入；lower/upper 直传原始值（元/股/百分数 5% 传 5.0）

  PRICE（id=2201 · simple · SimpleProperty） 最新价

  单位：元；lower/upper 直传原始价，OpenD 自动倍率转换

  req.add_simple_property(name=SimpleProperty.PRICE, lower=10.0)
  req.add_retrieve_simple(name=SimpleProperty.PRICE)
  req.set_sort(direction=ScrSortDir.DESC, property_type='simple',
               property_params={'name': int(SimpleProperty.PRICE)})
  

  实测返回（HK · all_count=485、命中 5 行、head 前 5）：

        stock_id   code    name   price
  47704201761008  04336  应用材料-T  1620.0
  87836376173009  02513      智谱  1097.0
  47704201761005  04333    思科-T   750.0
  86839943761574  03750    宁德时代   672.5
  87840671141778  03986    兆易创新   653.5
  

  MARKET_CAP（id=2301 · simple · SimpleProperty） 总市值

  单位：元；lower=100 亿写 10_000_000_000

  req.add_simple_property(name=SimpleProperty.MARKET_CAP, lower=10_000_000_000.0)
  req.add_retrieve_simple(name=SimpleProperty.MARKET_CAP)
  req.set_sort(direction=ScrSortDir.DESC, property_type='simple',
               property_params={'name': int(SimpleProperty.MARKET_CAP)})
  

  实测返回（HK · all_count=591、命中 5 行、head 前 5）：

        stock_id   code    name        market_cap
  54047868453564  00700    腾讯控股   4222484299075.2
  83820581829436  80700  腾讯控股-R   3641391766113.6
  86839943761574  03750    宁德时代   3111406771825.0
  47704201761005  04333    思科-T   2956075998750.0
  57754425230710  01398    工商银行  2573253176182.58
  

  PE_TTM（id=2303 · simple · SimpleProperty） PE(TTM)

  正常区间筛选；可为负

  req.add_simple_property(name=SimpleProperty.PE_TTM, lower=5.0, upper=20.0)
  req.add_retrieve_simple(name=SimpleProperty.PE_TTM)
  req.set_sort(direction=ScrSortDir.ASC, property_type='simple',
               property_params={'name': int(SimpleProperty.PE_TTM)})
  

  实测返回（HK · all_count=830、命中 5 行、head 前 5）：

        stock_id   code      name  pe_ttm
  28604482191640  00280      景福集团     5.0
  67345087202619  01339  中国人民保险集团   5.037
  68629282424057  01273      香港信贷  5.0847
  76063870813891  01731    其利工业集团  5.0877
  35433480192608  00608      达利国际  5.0877
  

  VOLUME_RATIO（id=2217 · simple · SimpleProperty） 量比

  今日成交量 / N 日均量；> 2 表示放量

  req.add_simple_property(name=SimpleProperty.VOLUME_RATIO, lower=2.0)
  req.add_retrieve_simple(name=SimpleProperty.VOLUME_RATIO)
  req.set_sort(direction=ScrSortDir.DESC, property_type='simple',
               property_params={'name': int(SimpleProperty.VOLUME_RATIO)})
  

  实测返回（HK · all_count=340、命中 5 行、head 前 5）：

        stock_id   code      name  volume_ratio
  50796578209975  00183      宏辉集团         600.0
  45999099741384  01224      中渝置地       404.642
            1543  01543  中盈盛达融资担保       400.714
  24142011170996  00180      开达集团       314.999
   5033701671181  00269    中国资源交通         200.0
  

  DIVIDEND_RATIO（id=2305 · simple · SimpleProperty） 股息率

  单位：% ；股息率 ≥ 5% 传 5.0

  req.add_simple_property(name=SimpleProperty.DIVIDEND_RATIO, lower=5.0)
  req.add_retrieve_simple(name=SimpleProperty.DIVIDEND_RATIO)
  req.set_sort(direction=ScrSortDir.DESC, property_type='simple',
               property_params={'name': int(SimpleProperty.DIVIDEND_RATIO)})
  

  实测返回（HK · all_count=0、命中 0 行）：无数据。原因：HK 当下抽样无 ≥ 5% 股息率股票，可降低 lower 阈值

  累计行情属性 CumulativeProperty

  通过 add_cumulative_property(name, days, lower, upper) 传入；百分数类（涨跌幅/换手率）传小数（5% 传 0.05）

  PRICE_CHANGE_PCT（id=3102 · cumulative · CumulativeProperty） N 日涨跌幅 %

  百分数传小数：5% 传 0.05；days 指 N 日累计窗口

  req.add_cumulative_property(name=CumulativeProperty.PRICE_CHANGE_PCT,
                              days=5, lower=0.05)
  req.add_retrieve_cumulative(name=CumulativeProperty.PRICE_CHANGE_PCT, days=5)
  req.set_sort(direction=ScrSortDir.DESC, property_type='cumulative',
               property_params={'name': int(CumulativeProperty.PRICE_CHANGE_PCT), 'days': 5})
  

  实测返回（HK · all_count=363、命中 5 行、head 前 5）：

        stock_id   code      name  change_pct_5d
  88510686038921  02953     嬴集团股权            4.0
  77640123811704  01912       康特隆         2.7679
  47704201761005  04333      思科-T         2.2029
  88467736365964  02956  中国健康科技股权         1.6667
  47704201761008  04336    应用材料-T         1.4384
  

  AMPLITUDE（id=3103 · cumulative · CumulativeProperty） N 日振幅 %

  同 PRICE_CHANGE_PCT，百分数传小数

  req.add_cumulative_property(name=CumulativeProperty.AMPLITUDE,
                              days=20, lower=0.1)
  req.add_retrieve_cumulative(name=CumulativeProperty.AMPLITUDE, days=20)
  req.set_sort(direction=ScrSortDir.DESC, property_type='cumulative',
               property_params={'name': int(CumulativeProperty.AMPLITUDE), 'days': 20})
  

  实测返回（HK · all_count=2345、命中 5 行、head 前 5）：

        stock_id   code    name  amp_20d
  47704201761008  04336  应用材料-T  43.3783
  55671366092780  02028    映美控股   9.0893
  59558311493749  00117  天利控股集团   8.0532
  42623255446398  00894    万裕科技     7.59
  88433376627363  02723    深演智能   6.3243
  

  AVG_VOLUME（id=3104 · cumulative · CumulativeProperty） N 日均量

  单位：股；N 日成交量算术平均

  req.add_cumulative_property(name=CumulativeProperty.AVG_VOLUME,
                              days=20, lower=1_000_000)
  req.add_retrieve_cumulative(name=CumulativeProperty.AVG_VOLUME, days=20)
  req.set_sort(direction=ScrSortDir.DESC, property_type='cumulative',
               property_params={'name': int(CumulativeProperty.AVG_VOLUME), 'days': 20})
  

  实测返回（HK · all_count=2295、命中 5 行、head 前 5）：

        stock_id   code    name  avg_vol_20d
  84688165145005  02477    经纬天地  15586288027
  58506044508119  02007     碧桂园  11318232417
  69325067126991  02255  海昌海洋公园  10691740000
  81462644703252  00020    商汤-W   9517974535
  79671643350793  09993    金辉控股   7418314265
  

  TURNOVER_RATIO（id=3106 · cumulative · CumulativeProperty） N 日累计换手率

  单位：% ；百分数传小数（5% 传 0.05）

  req.add_cumulative_property(name=CumulativeProperty.TURNOVER_RATIO,
                              days=20, lower=0.05)
  req.add_retrieve_cumulative(name=CumulativeProperty.TURNOVER_RATIO, days=20)
  req.set_sort(direction=ScrSortDir.DESC, property_type='cumulative',
               property_params={'name': int(CumulativeProperty.TURNOVER_RATIO), 'days': 20})
  

  实测返回（HK · all_count=800、命中 5 行、head 前 5）：

        stock_id   code   name  turnover_ratio_20d
  58196806861368  00568   山东墨龙              6.7527
  84688165145005  02477   经纬天地              3.8966
  88089779243675  02715    埃斯顿              3.7288
  84434762074537  02473  喜相逢集团              3.4646
  87230785784391  02631   天岳先进              3.2208
  

  财务属性 FinancialProperty

  通过 add_financial_property(name, term, year, lower, upper) 传入；term 取自 Term 枚举（年报=100、Q1=1、TTM 类不需要 term）；比率类传小数（15% 传 0.15）

  NET_PROFIT（id=4101 · financial · FinancialProperty） 净利润

  单位：元；term=ANNUAL(100) 年报、Q1=1、Q2/Q3/Q4 部分港股无数据

  req.add_financial_property(name=FinancialProperty.NET_PROFIT,
                             term=Term.ANNUAL, lower=1_000_000_000.0)
  req.add_retrieve_financial(name=FinancialProperty.NET_PROFIT, term=Term.ANNUAL)
  req.set_sort(direction=ScrSortDir.DESC, property_type='financial',
               property_params={'name': int(FinancialProperty.NET_PROFIT),
                                'term': int(Term.ANNUAL)})
  

  实测返回（HK · all_count=437、命中 5 行、head 前 5）：

        stock_id   code    name      net_profit
  57754425230710  01398    工商银行  412328868600.0
  56186762167211  00939    建设银行  377880459000.0
  63586990818568  01288    农业银行  324736536300.0
  57118770073492  03988    中国银行  286850625600.0
  83820581829436  80700  腾讯控股-R  255561692100.0
  

  ROE（id=4110 · financial · FinancialProperty） 净资产收益率

  单位：% ；百分数传小数（15% 传 0.15）；term=ANNUAL

  req.add_financial_property(name=FinancialProperty.ROE,
                             term=Term.ANNUAL, lower=0.15)
  req.add_retrieve_financial(name=FinancialProperty.ROE, term=Term.ANNUAL)
  req.set_sort(direction=ScrSortDir.DESC, property_type='financial',
               property_params={'name': int(FinancialProperty.ROE),
                                'term': int(Term.ANNUAL)})
  

  实测返回（HK · all_count=322、命中 5 行、head 前 5）：

        stock_id   code    name      roe
  62487479191132  01628    禹洲集团   40.644
  69823283339309  08237    华星控股  12.6906
  52845277610549  00565  锦艺集团控股   3.0644
  86882893433405  02621    手回集团   2.7027
  64969970288874  02282   美高梅中国   2.6886
  

  REVENUE_GROWTH（id=4106 · financial · FinancialProperty） 营收同比增长率

  单位：% ；百分数传小数（20% 传 0.20）；term=ANNUAL

  req.add_financial_property(name=FinancialProperty.REVENUE_GROWTH,
                             term=Term.ANNUAL, lower=0.20)
  req.add_retrieve_financial(name=FinancialProperty.REVENUE_GROWTH, term=Term.ANNUAL)
  req.set_sort(direction=ScrSortDir.DESC, property_type='financial',
               property_params={'name': int(FinancialProperty.REVENUE_GROWTH),
                                'term': int(Term.ANNUAL)})
  

  实测返回（HK · all_count=638、命中 5 行、head 前 5）：

        stock_id   code    name  revenue_growth
  46772193854353  00913    港湾数字        106.7922
  88377542057458  07666  剂泰科技-P          73.067
  53047141075220  02324    首都创投         63.5792
  43589623088228  01124    沿海家园         26.7323
  74259984551169  03329    交银国际         20.5256
  

  BASIC_EPS（id=4801 · financial · FinancialProperty） 基本每股收益

  单位：元；term=ANNUAL

  req.add_financial_property(name=FinancialProperty.BASIC_EPS,
                             term=Term.ANNUAL, lower=1.0)
  req.add_retrieve_financial(name=FinancialProperty.BASIC_EPS, term=Term.ANNUAL)
  req.set_sort(direction=ScrSortDir.DESC, property_type='financial',
               property_params={'name': int(FinancialProperty.BASIC_EPS),
                                'term': int(Term.ANNUAL)})
  

  实测返回（HK · all_count=324、命中 5 行、head 前 5）：

        stock_id   code             name      basic_eps
  86998857554659  06883             颖通控股  123007487.548
  88261577939456  06656             思格新能        139.457
  69290707392656  06288  FAST RETAIL-DRS         74.984
  80418967660265  09961           携程集团-S         56.044
  85439784425509  06181             老铺黄金         31.388
  

  DIVIDENDS_TTM_RATIO（id=4219 · financial · FinancialProperty） TTM 股息率

  单位：% ；百分数传小数；TTM 类不需要 term/year

  req.add_financial_property(name=FinancialProperty.DIVIDENDS_TTM_RATIO, lower=0.05)
  req.add_retrieve_financial(name=FinancialProperty.DIVIDENDS_TTM_RATIO)
  req.set_sort(direction=ScrSortDir.DESC, property_type='financial',
               property_params={'name': int(FinancialProperty.DIVIDENDS_TTM_RATIO)})
  

  实测返回（HK · all_count=463、命中 5 行、head 前 5）：

        stock_id   code    name  div_ttm_ratio
  50856707752105  00169  万达酒店发展         4.0526
            2136  02136    利福中国         0.6562
  77622943942788  02180    万宝盛华         0.3752
  75419625726233  08473  弥明生活百货         0.3303
  64896955845349  02789    远大中国         0.2994
  

  技术指标位置关系 Indicator

  通过 add_indicator_positional(first_indicator_name, period_type, position, second_indicator=None, value=None, first_indicator_params=None) 传入；position 取自 Position（OVER=1、BELOW=2、CROSS_UP=3、CROSS_DOWN=4）

  MA5 / MA20（id=11 · indicator · Indicator） MA5 上穿 MA20

  add_indicator_positional：first/second 都是 Indicator 枚举；位置 CROSS_UP=3、CROSS_DOWN=4、OVER=1、BELOW=2

  req.add_indicator_positional(first_indicator_name=Indicator.MA5,
                               period_type=Period.DAY,
                               position=Position.CROSS_UP,
                               second_indicator=Indicator.MA20)
  

  实测返回（HK · all_count=67、命中 5 行、head 前 5）：

        stock_id   code    name
  88356067214548  01236   乐动机器人
  88313117542845  02493  迈威生物-B
  88179973556902  02726    瀚天天成
  87033217287972  01828    富卫集团
  86968792779992  03288    海天味业
  

  RSI（id=52 · indicator · Indicator） RSI 超买（>70）

  指标参数通过 first_indicator_params 传入，例如 RSI 周期 14；单值比较用 second_value

  req.add_indicator_positional(first_indicator_name=Indicator.RSI,
                               period_type=Period.DAY,
                               position=Position.OVER, second_value=70,
                               first_indicator_params=[14])
  

  实测返回（HK · all_count=97、命中 5 行、head 前 5）：

        stock_id   code     name
  88502096109937  08561  爱世纪集团股权
  88476326299379  01779   天辰生物-B
  88450556496782  02958  远见控股(旧)
  88416196762328  06872   丹诺医药-B
  88407606823814  02950  升能集团(旧)
  

  MACD_DIF（id=41 · indicator · Indicator） MACD DIF 在零轴上方

  second_value 为单值阈值；position=OVER 表示 DIF > 0

  req.add_indicator_positional(first_indicator_name=Indicator.MACD_DIF,
                               period_type=Period.DAY,
                               position=Position.OVER, second_value=0)
  

  实测返回（HK · all_count=786、命中 5 行、head 前 5）：

        stock_id   code      name
  88476326299379  01779    天辰生物-B
  88467736365964  02956  中国健康科技股权
  88450556496782  02958   远见控股(旧)
  88437671594888  02952  杭品生活科技股权
  88433376627363  02723      深演智能
  

  PRICE / BOLL_UPPER（id=1 · indicator · Indicator） 股价上穿布林上轨

  PRICE(1) 与 BOLL_UPPER(61) 比较位置

  req.add_indicator_positional(first_indicator_name=Indicator.PRICE,
                               period_type=Period.DAY,
                               position=Position.CROSS_UP,
                               second_indicator=Indicator.BOLL_UPPER)
  

  实测返回（HK · all_count=50、命中 5 行、head 前 5）：

        stock_id   code    name
  87544318404244  09876  大洋环球控股
  85864986184208  02576  太美医疗科技
  84482006714840  02520    山西安装
  83000243002163  06963    阳光保险
  82961588291781  02245    力勤资源
  

  技术指标形态 Pattern

  通过 add_indicator_pattern(name, period_type) 传入；name 取自 Pattern 枚举

  MACD_GOLD_CROSS（id=21 · pattern · Pattern） MACD 金叉

  add_indicator_pattern：name 取自 Pattern 枚举

  req.add_indicator_pattern(name=Pattern.MACD_GOLD_CROSS, period_type=Period.DAY)
  

  实测返回（HK · all_count=116、命中 5 行、head 前 5）：

        stock_id   code      name
  88502096109937  08561   爱世纪集团股权
  88416196764014  08558  麦迪森控股(旧)
  88265872906147  06051        有赞
  86998857553944  06168       周六福
  86822763895471  06831      绿茶集团
  

  KDJ_GOLD_CROSS（id=11 · pattern · Pattern） KDJ 金叉

  同上，K 上穿 D

  req.add_indicator_pattern(name=Pattern.KDJ_GOLD_CROSS, period_type=Period.DAY)
  

  实测返回（HK · all_count=179、命中 5 行、head 前 5）：

        stock_id   code           name
  88480621267856  02960  ALCO HOLD RTS
  88420491725703  02951        京玖康疗(旧)
  88179973556702  02526           德适-B
  87746181861167  03887  HASHKEY HLDGS
  87741886892639  02655           果下科技
  

  BOLL_BREAK_UPPER（id=41 · pattern · Pattern） 股价突破布林上轨

  BOLL 形态系列 41~44

  req.add_indicator_pattern(name=Pattern.BOLL_BREAK_UPPER, period_type=Period.DAY)
  

  实测返回（HK · all_count=50、命中 5 行、head 前 5）：

        stock_id   code    name
  87544318404244  09876  大洋环球控股
  85864986184208  02576  太美医疗科技
  84482006714840  02520    山西安装
  83000243002163  06963    阳光保险
  82961588291781  02245    力勤资源
  

  特色指标 FeaturedProperty

  通过 add_featured_property(name, intervals, value_set, period, range_period, first_custom_param) 传入；区间用 intervals=[(lower, upper)]，枚举用 value_set=[...]

  SHORT_POSITION（id=5110 · featured · FeaturedProperty） 空头持仓

  单位：股；不需 intervals

  req.add_featured_property(name=FeaturedProperty.SHORT_POSITION)
  req.add_retrieve_featured(name=FeaturedProperty.SHORT_POSITION)
  req.set_sort(direction=ScrSortDir.DESC, property_type='featured',
               property_params={'name': int(FeaturedProperty.SHORT_POSITION)})
  

  实测返回（HK · all_count=0、命中 0 行）：无数据。原因：该 featured 因子 HK 暂未暴露数据，需切换 US 市场查询

  ANALYST_RATING（id=5401 · featured · FeaturedProperty） 分析师评级

  枚举值：1=强烈买入、2=买入、3=持有、4=卖出、5=强烈卖出；value_set 传枚举列表

  req.add_featured_property(name=FeaturedProperty.ANALYST_RATING, value_set=[1, 2])
  req.add_retrieve_featured(name=FeaturedProperty.ANALYST_RATING)
  req.set_sort(direction=ScrSortDir.ASC, property_type='featured',
               property_params={'name': int(FeaturedProperty.ANALYST_RATING)})
  

  实测返回（HK · all_count=0、命中 0 行）：无数据。原因：需切换至覆盖率更高的 US 市场，或放宽 value_set

  ANALYST_TARGET_PRICE（id=5403 · featured · FeaturedProperty） 分析师目标价

  单位：元；区间用 dict 列表 [{'lower': {'value': X, 'includes': True}}]，上下限可省

  req.add_featured_property(name=FeaturedProperty.ANALYST_TARGET_PRICE,
                            intervals=[{'lower': {'value': 100.0, 'includes': True}}])
  req.add_retrieve_featured(name=FeaturedProperty.ANALYST_TARGET_PRICE)
  req.set_sort(direction=ScrSortDir.DESC, property_type='featured',
               property_params={'name': int(FeaturedProperty.ANALYST_TARGET_PRICE)})
  

  实测返回（HK · all_count=0、命中 0 行）：无数据。原因：需切换至覆盖率更高的 US 市场，或放宽 intervals 下限

  HIST_PERCENTILE_PE（id=5502 · featured · FeaturedProperty） 当前 PE 历史百分位

  range_period 必传：RangePeriod 枚举 (THREE_MONTHS=1、SIX_MONTHS=2、ONE_YEAR=3、THREE_YEARS=4)

  req.add_featured_property(name=FeaturedProperty.HIST_PERCENTILE_PE,
                            range_period=RangePeriod.THREE_YEARS,
                            intervals=[{'upper': {'value': 0.30, 'includes': True}}])
  req.add_retrieve_featured(name=FeaturedProperty.HIST_PERCENTILE_PE,
                            range_period=RangePeriod.THREE_YEARS)
  req.set_sort(direction=ScrSortDir.ASC, property_type='featured',
               property_params={'name': int(FeaturedProperty.HIST_PERCENTILE_PE),
                                'rangePeriod': int(RangePeriod.THREE_YEARS)})
  

  实测返回（HK · all_count=0、命中 0 行）：无数据。原因：HK 部分股票无历史 PE 数据，可放宽 range_period / intervals

  CASH_FLOW_MAIN_NET_IN（id=5901 · featured · FeaturedProperty） 主力资金净流入

  单位：元；资金流入用 CashFlowPeriod 枚举 (DAY=1、WEEK=2、MONTH_P=3、QUARTER=4)

  req.add_featured_property(name=FeaturedProperty.CASH_FLOW_MAIN_NET_IN,
                            range_period=CashFlowPeriod.DAY,
                            intervals=[{'lower': {'value': 10_000_000.0, 'includes': True}}])
  req.add_retrieve_featured(name=FeaturedProperty.CASH_FLOW_MAIN_NET_IN,
                            range_period=CashFlowPeriod.DAY)
  req.set_sort(direction=ScrSortDir.DESC, property_type='featured',
               property_params={'name': int(FeaturedProperty.CASH_FLOW_MAIN_NET_IN),
                                'rangePeriod': int(CashFlowPeriod.DAY)})
  

  实测返回（HK · all_count=0、命中 0 行）：无数据。原因：HK 实测无数据，建议改用 US 市场或更短周期

  经纪商持股 BrokerProperty

  通过 add_broker_holdings(name, days, param, intervals) 传入；仅港股；6101/6102/6105/6106/6107 倍率 1000，按百分数传值（20% 传 20）

  CONCENTRATED_DISTRIBUTION（id=6101 · broker · BrokerProperty） 经纪商集中度

  仅港股；intervals 按 dict 列表传，单位 %（20% 传 20.0）；param=经纪商代码逗号分隔

  req.add_broker_holdings(name=BrokerProperty.CONCENTRATED_DISTRIBUTION,
                          intervals=[{'lower': {'value': 20.0, 'includes': True}}])
  req.add_retrieve_broker(name=BrokerProperty.CONCENTRATED_DISTRIBUTION)
  req.set_sort(direction=ScrSortDir.DESC, property_type='broker',
               property_params={'name': int(BrokerProperty.CONCENTRATED_DISTRIBUTION)})
  

  实测返回（HK · all_count=0、命中 0 行）：无数据。原因：若 HK OpenD 未订阅 broker 行情则返回 0，可放低 lower

  CENTRAL_HOLDINGS_RATIO（id=6106 · broker · BrokerProperty） 中央结算系统持股占比

  仅港股；intervals 按 dict 列表传，单位 %

  req.add_broker_holdings(name=BrokerProperty.CENTRAL_HOLDINGS_RATIO,
                          intervals=[{'lower': {'value': 10.0, 'includes': True}}])
  req.add_retrieve_broker(name=BrokerProperty.CENTRAL_HOLDINGS_RATIO)
  req.set_sort(direction=ScrSortDir.DESC, property_type='broker',
               property_params={'name': int(BrokerProperty.CENTRAL_HOLDINGS_RATIO)})
  

  实测返回（HK · all_count=0、命中 0 行）：无数据。原因：若 HK OpenD 未订阅 broker 行情则返回 0，可放低 lower

  BROKER_NUM（id=6103 · broker · BrokerProperty） 持有该股的经纪商数量

  仅港股；整数（intervals 用 dict 列表）

  req.add_broker_holdings(name=BrokerProperty.BROKER_NUM,
                          intervals=[{'lower': {'value': 100, 'includes': True}}])
  req.add_retrieve_broker(name=BrokerProperty.BROKER_NUM)
  req.set_sort(direction=ScrSortDir.DESC, property_type='broker',
               property_params={'name': int(BrokerProperty.BROKER_NUM)})
  

  实测返回（HK · all_count=0、命中 0 行）：无数据。原因：若 HK OpenD 未订阅 broker 行情则返回 0

  K 线形态 KlineShapeProperty

  通过 add_kline_shape(name, period, value_set) 传入；period 必传，目前仅支持日 K(Period.DAY=11) 与 1 小时 K(Period.HOUR_1=5)

  SHAPE_TYPE（id=6200 · kline_shape · KlineShapeProperty） K 线形态识别

  period 必传：日 K=11、1 小时 K=5（实测发现 SDK 文档曾标注 21，但 21 实为周 K，应传 5）；value_set 取自 KlineShapeType

  req.add_kline_shape(name=KlineShapeProperty.SHAPE_TYPE, period=Period.DAY,
                      value_set=[KlineShapeType.DOUBLE_BOTTOMS,
                                 KlineShapeType.HEAD_SHOULDERS_BOTTOM])
  req.add_retrieve_kline_shape(name=KlineShapeProperty.SHAPE_TYPE, period=Period.DAY)
  

  实测返回（HK · all_count=0、命中 0 行）：无数据。原因：指定形态 + 区间无命中，可放宽 value_set

  RISE_PROB（id=6201 · kline_shape · KlineShapeProperty） 形态后上涨概率

  单位：% ；与 SHAPE_TYPE 联合使用

  req.add_kline_shape(name=KlineShapeProperty.SHAPE_TYPE, period=Period.DAY,
                      value_set=[KlineShapeType.DOUBLE_BOTTOMS])
  req.add_retrieve_kline_shape(name=KlineShapeProperty.RISE_PROB, period=Period.DAY)
  req.set_sort(direction=ScrSortDir.DESC, property_type='kline_shape',
               property_params={'name': int(KlineShapeProperty.RISE_PROB),
                                'period': int(Period.DAY)})
  

  实测返回（HK · all_count=0、命中 0 行）：无数据。原因：与 SHAPE_TYPE 联用；HK 抽样无命中

  期权属性 OptionProperty

  通过 add_option(name, intervals, param, period) 传入；用于按正股 IV / HV 等期权维度筛选

  STOCK_IV（id=1000 · option · OptionProperty） 正股期权隐含波动率

  单位：% ；intervals 用 dict 列表；period 取自 OptionHVPeriod (HV_30D/60D/90D/120D/365D)

  req.add_option(name=OptionProperty.STOCK_IV,
                 intervals=[{'lower': {'value': 30.0, 'includes': True}}])
  req.add_retrieve_option(name=OptionProperty.STOCK_IV)
  req.set_sort(direction=ScrSortDir.DESC, property_type='option',
               property_params={'name': int(OptionProperty.STOCK_IV)})
  

  实测返回（HK · all_count=0、命中 0 行）：无数据。原因：需切换至期权全集市场（US）或放低 intervals 下限

  STOCK_IV_RANK（id=1001 · option · OptionProperty） 正股 IV Rank

  0~100；衡量当前 IV 在历史中的相对位置（intervals 用 dict 列表）

  req.add_option(name=OptionProperty.STOCK_IV_RANK,
                 intervals=[{'lower': {'value': 50.0, 'includes': True}}])
  req.add_retrieve_option(name=OptionProperty.STOCK_IV_RANK)
  req.set_sort(direction=ScrSortDir.DESC, property_type='option',
               property_params={'name': int(OptionProperty.STOCK_IV_RANK)})
  

  实测返回（HK · all_count=0、命中 0 行）：无数据。原因：需切换至期权全集市场（US）或放低 intervals 下限

  STOCK_HV（id=1006 · option · OptionProperty） 正股历史波动率

  单位：% ；intervals 用 dict 列表；period 取自 OptionHVPeriod

  req.add_option(name=OptionProperty.STOCK_HV,
                 intervals=[{'lower': {'value': 20.0, 'includes': True}}])
  req.add_retrieve_option(name=OptionProperty.STOCK_HV)
  req.set_sort(direction=ScrSortDir.DESC, property_type='option',
               property_params={'name': int(OptionProperty.STOCK_HV)})
  

  实测返回（HK · all_count=0、命中 0 行）：无数据。原因：需切换至期权全集市场（US）或放低 intervals 下限

Qot_StockScreen.proto

• 介绍

  条件选股 V2

• 参数

message Boundary
{
    required double value = 1;
    optional bool includes = 2;     // 是否闭区间，默认 true
}

message Interval
{
    optional Boundary filterMin = 1;
    optional Boundary filterMax = 2;
}

// ===== 各类 PropertyXxx =====
message PropertyBasic         { required int32 name = 1; }
message PropertySimple        { required int32 name = 1; optional int32 unit = 2; }
message PropertyCumulative    {
    required int32 name = 1;
    required int32 days = 2;
    optional int32 periodAverage = 3;
    optional int32 unit = 4;
}
message PropertyFinancial     {
    required int32 name = 1;
    optional int32 term = 2;
    optional int32 year = 3;
    optional int32 duration = 4;
    optional int32 periodAverage = 5;
    optional int32 futureDuration = 6;
    optional int32 unit = 7;
}
message PropertyIndicator     {
    required int32 name = 1;
    optional int32 period = 2;
    repeated int32 indicatorParams = 3;
}
message PropertyFeatured      {
    required int32 name = 1;
    optional int32 period = 2;
    optional int32 rangePeriod = 3;
    optional int32 firstCustomParam = 4;
}
message PropertyBroker        {
    required int32 name = 1;
    optional int32 days = 2;
    optional string param = 3;
}
message PropertyOption        {
    required int32 name = 1;
    optional int32 period = 2;
    optional string param = 3;
}
message PropertyKlineShape    {
    required int32 name = 1;
    optional int32 period = 2;
}

// ===== 各类 QueryXxx =====
message SimpleFieldQuery
{
    required int32 simpleField = 1;
    repeated int32 screenValueList = 2;
}

message PlateInfo
{
    repeated string plateIdList = 1;
    optional string parentPlateId = 2;
}

message PlateQuery       { repeated PlateInfo plateList = 1; }

message SimplePropertyQuery
{
    required PropertySimple property = 1;
    optional Boundary filterMin = 2;
    optional Boundary filterMax = 3;
}

message CumulativePropertyQuery
{
    required PropertyCumulative property = 1;
    optional Boundary filterMin = 2;
    optional Boundary filterMax = 3;
    optional int32 continuousPeriod = 4;
}

message FinancialPropertyQuery
{
    required PropertyFinancial property = 1;
    optional Boundary filterMin = 2;
    optional Boundary filterMax = 3;
    optional int32 continuousPeriod = 4;
}

message IndicatorPositionalQuery
{
    required int32 firstIndicatorName = 1;
    required int32 periodType = 2;
    required int32 position = 3;
    optional int32 secondIndicator = 4;
    optional int32 secondValue = 5;
    repeated int32 firstIndicatorParams = 6;
    repeated int32 secondIndicatorParams = 7;
    optional int32 continuousPeriod = 8;
    repeated Interval intervals = 9;
}

message IndicatorPatternQuery
{
    required int32 name = 1;
    required int32 periodType = 2;
    optional int32 continuousPeriod = 3;
    optional bool isMatching = 4;
    repeated int32 subPatterns = 5;
}

message FeaturedPropertyQuery
{
    required PropertyFeatured property = 1;
    repeated Interval intervals = 2;
    repeated int32 valueSet = 3;
}

message BrokerHoldingsQuery
{
    required PropertyBroker property = 1;
    repeated Interval intervals = 2;
}

message KlineShapeQuery
{
    required PropertyKlineShape property = 1;
    repeated int32 valueSet = 2;
}

message OptionQuery
{
    required PropertyOption property = 1;
    repeated Interval intervals = 2;
}

// ===== 一条筛选条件 (oneof 多选一) =====
message ScreenQuery
{
    optional SimpleFieldQuery simpleFieldQuery = 1;
    optional PlateQuery plateQuery = 2;
    optional SimplePropertyQuery simplePropertyQuery = 3;
    optional CumulativePropertyQuery cumulativePropertyQuery = 4;
    optional FinancialPropertyQuery financialPropertyQuery = 5;
    optional IndicatorPositionalQuery indicatorPositionalQuery = 6;
    optional IndicatorPatternQuery indicatorPatternQuery = 7;
    optional FeaturedPropertyQuery featuredPropertyQuery = 8;
    optional BrokerHoldingsQuery brokerHoldingsQuery = 9;
    optional KlineShapeQuery klineShapeQuery = 10;
    optional OptionQuery optionQuery = 11;
}

// ===== 取回字段 =====
message RetrieveQuery
{
    optional PropertyBasic basicProperty = 1;
    optional PropertySimple simpleProperty = 2;
    optional PropertyCumulative cumulativeProperty = 3;
    optional PropertyFinancial financialProperty = 4;
    optional PropertyIndicator indicatorProperty = 5;
    optional PropertyFeatured featuredProperty = 6;
    optional PropertyBroker brokerProperty = 7;
    optional PropertyOption optionProperty = 8;
    optional PropertyKlineShape klineShapeProperty = 9;
}

// ===== 排序定义 =====
message Sort
{
    required int32 direction = 1;   // 1=ASC, 2=DESC, 3=ABS_ASC, 4=ABS_DESC
    optional PropertyBasic basicProperty = 2;
    optional PropertySimple simpleProperty = 3;
    optional PropertyCumulative cumulativeProperty = 4;
    optional PropertyFinancial financialProperty = 5;
    optional PropertyIndicator indicatorProperty = 6;
    optional PropertyFeatured featuredProperty = 7;
    optional PropertyBroker brokerProperty = 8;
    optional PropertyOption optionProperty = 9;
    optional PropertyKlineShape klineShapeProperty = 10;
}

message C2S
{
    repeated ScreenQuery filterList = 1;
    repeated RetrieveQuery retrieveList = 2;
    repeated int64 watchlistStockIds = 3;
    optional Sort sort = 4;             // 单字段排序
    optional int32 pageFrom = 5;
    optional int32 pageCount = 6;
    repeated Sort sortList = 7;         // 多字段排序，非空时优先于 sort
}

message Request
{
    required C2S c2s = 1;
}

• 返回

// 单条结果值: valueType=1 时取 sval, =2 取 ival, =3 取 aval, =4 取 dval
message ResultPropertyBasic
{
    required PropertyBasic property = 1;
    optional int32 valueType = 2;
    optional string sval = 3;
    optional int64 ival = 4;
    repeated int64 aval = 5;
    optional double dval = 6;
    optional string enumTypeName = 7;
    optional string enumName = 8;
}
// 其余 ResultPropertySimple / Cumulative / Financial / Indicator / Featured / Broker / Option / KlineShape
// 结构与 ResultPropertyBasic 相同，仅 property 类型不同。Financial 额外包含 endTime。

message RspItemResult
{
    optional ResultPropertyBasic basicPropertyResult = 1;
    optional ResultPropertySimple simplePropertyResult = 2;
    optional ResultPropertyCumulative cumulativePropertyResult = 3;
    optional ResultPropertyFinancial financialPropertyResult = 4;
    optional ResultPropertyIndicator indicatorPropertyResult = 5;
    optional ResultPropertyFeatured featuredPropertyResult = 6;
    optional ResultPropertyBroker brokerPropertyResult = 7;
    optional ResultPropertyOption optionPropertyResult = 8;
    optional ResultPropertyKlineShape klineShapePropertyResult = 9;
}

message RspItem
{
    required int64 stockId = 1;
    repeated RspItemResult results = 2;
}

message S2C
{
    required bool lastPage = 1;
    required int32 allCount = 2;
    repeated RspItem dataList = 3;
}

message Response
{
    required int32 retType = 1 [default = -400];
    optional string retMsg = 2;
    optional int32 errCode = 3;
    optional S2C s2c = 4;
}

• 接口调用结果，结构参见 RetType

• 协议 ID

  3252

uint StockScreen(QotStockScreen.Request req); virtual void OnReply_StockScreen(FTAPI_Conn client, uint nSerialNo, QotStockScreen.Response rsp);

• 介绍

  条件选股 V2

• 参数

message Boundary
{
    required double value = 1;
    optional bool includes = 2;     // 是否闭区间，默认 true
}

message Interval
{
    optional Boundary filterMin = 1;
    optional Boundary filterMax = 2;
}

// ===== 各类 PropertyXxx =====
message PropertyBasic         { required int32 name = 1; }
message PropertySimple        { required int32 name = 1; optional int32 unit = 2; }
message PropertyCumulative    {
    required int32 name = 1;
    required int32 days = 2;
    optional int32 periodAverage = 3;
    optional int32 unit = 4;
}
message PropertyFinancial     {
    required int32 name = 1;
    optional int32 term = 2;
    optional int32 year = 3;
    optional int32 duration = 4;
    optional int32 periodAverage = 5;
    optional int32 futureDuration = 6;
    optional int32 unit = 7;
}
message PropertyIndicator     {
    required int32 name = 1;
    optional int32 period = 2;
    repeated int32 indicatorParams = 3;
}
message PropertyFeatured      {
    required int32 name = 1;
    optional int32 period = 2;
    optional int32 rangePeriod = 3;
    optional int32 firstCustomParam = 4;
}
message PropertyBroker        {
    required int32 name = 1;
    optional int32 days = 2;
    optional string param = 3;
}
message PropertyOption        {
    required int32 name = 1;
    optional int32 period = 2;
    optional string param = 3;
}
message PropertyKlineShape    {
    required int32 name = 1;
    optional int32 period = 2;
}

// ===== 各类 QueryXxx =====
message SimpleFieldQuery
{
    required int32 simpleField = 1;
    repeated int32 screenValueList = 2;
}

message PlateInfo
{
    repeated string plateIdList = 1;
    optional string parentPlateId = 2;
}

message PlateQuery       { repeated PlateInfo plateList = 1; }

message SimplePropertyQuery
{
    required PropertySimple property = 1;
    optional Boundary filterMin = 2;
    optional Boundary filterMax = 3;
}

message CumulativePropertyQuery
{
    required PropertyCumulative property = 1;
    optional Boundary filterMin = 2;
    optional Boundary filterMax = 3;
    optional int32 continuousPeriod = 4;
}

message FinancialPropertyQuery
{
    required PropertyFinancial property = 1;
    optional Boundary filterMin = 2;
    optional Boundary filterMax = 3;
    optional int32 continuousPeriod = 4;
}

message IndicatorPositionalQuery
{
    required int32 firstIndicatorName = 1;
    required int32 periodType = 2;
    required int32 position = 3;
    optional int32 secondIndicator = 4;
    optional int32 secondValue = 5;
    repeated int32 firstIndicatorParams = 6;
    repeated int32 secondIndicatorParams = 7;
    optional int32 continuousPeriod = 8;
    repeated Interval intervals = 9;
}

message IndicatorPatternQuery
{
    required int32 name = 1;
    required int32 periodType = 2;
    optional int32 continuousPeriod = 3;
    optional bool isMatching = 4;
    repeated int32 subPatterns = 5;
}

message FeaturedPropertyQuery
{
    required PropertyFeatured property = 1;
    repeated Interval intervals = 2;
    repeated int32 valueSet = 3;
}

message BrokerHoldingsQuery
{
    required PropertyBroker property = 1;
    repeated Interval intervals = 2;
}

message KlineShapeQuery
{
    required PropertyKlineShape property = 1;
    repeated int32 valueSet = 2;
}

message OptionQuery
{
    required PropertyOption property = 1;
    repeated Interval intervals = 2;
}

// ===== 一条筛选条件 (oneof 多选一) =====
message ScreenQuery
{
    optional SimpleFieldQuery simpleFieldQuery = 1;
    optional PlateQuery plateQuery = 2;
    optional SimplePropertyQuery simplePropertyQuery = 3;
    optional CumulativePropertyQuery cumulativePropertyQuery = 4;
    optional FinancialPropertyQuery financialPropertyQuery = 5;
    optional IndicatorPositionalQuery indicatorPositionalQuery = 6;
    optional IndicatorPatternQuery indicatorPatternQuery = 7;
    optional FeaturedPropertyQuery featuredPropertyQuery = 8;
    optional BrokerHoldingsQuery brokerHoldingsQuery = 9;
    optional KlineShapeQuery klineShapeQuery = 10;
    optional OptionQuery optionQuery = 11;
}

// ===== 取回字段 =====
message RetrieveQuery
{
    optional PropertyBasic basicProperty = 1;
    optional PropertySimple simpleProperty = 2;
    optional PropertyCumulative cumulativeProperty = 3;
    optional PropertyFinancial financialProperty = 4;
    optional PropertyIndicator indicatorProperty = 5;
    optional PropertyFeatured featuredProperty = 6;
    optional PropertyBroker brokerProperty = 7;
    optional PropertyOption optionProperty = 8;
    optional PropertyKlineShape klineShapeProperty = 9;
}

// ===== 排序定义 =====
message Sort
{
    required int32 direction = 1;   // 1=ASC, 2=DESC, 3=ABS_ASC, 4=ABS_DESC
    optional PropertyBasic basicProperty = 2;
    optional PropertySimple simpleProperty = 3;
    optional PropertyCumulative cumulativeProperty = 4;
    optional PropertyFinancial financialProperty = 5;
    optional PropertyIndicator indicatorProperty = 6;
    optional PropertyFeatured featuredProperty = 7;
    optional PropertyBroker brokerProperty = 8;
    optional PropertyOption optionProperty = 9;
    optional PropertyKlineShape klineShapeProperty = 10;
}

message C2S
{
    repeated ScreenQuery filterList = 1;
    repeated RetrieveQuery retrieveList = 2;
    repeated int64 watchlistStockIds = 3;
    optional Sort sort = 4;             // 单字段排序
    optional int32 pageFrom = 5;
    optional int32 pageCount = 6;
    repeated Sort sortList = 7;         // 多字段排序，非空时优先于 sort
}

message Request
{
    required C2S c2s = 1;
}

• 返回

// 单条结果值: valueType=1 时取 sval, =2 取 ival, =3 取 aval, =4 取 dval
message ResultPropertyBasic
{
    required PropertyBasic property = 1;
    optional int32 valueType = 2;
    optional string sval = 3;
    optional int64 ival = 4;
    repeated int64 aval = 5;
    optional double dval = 6;
    optional string enumTypeName = 7;
    optional string enumName = 8;
}
// 其余 ResultPropertySimple / Cumulative / Financial / Indicator / Featured / Broker / Option / KlineShape
// 结构与 ResultPropertyBasic 相同，仅 property 类型不同。Financial 额外包含 endTime。

message RspItemResult
{
    optional ResultPropertyBasic basicPropertyResult = 1;
    optional ResultPropertySimple simplePropertyResult = 2;
    optional ResultPropertyCumulative cumulativePropertyResult = 3;
    optional ResultPropertyFinancial financialPropertyResult = 4;
    optional ResultPropertyIndicator indicatorPropertyResult = 5;
    optional ResultPropertyFeatured featuredPropertyResult = 6;
    optional ResultPropertyBroker brokerPropertyResult = 7;
    optional ResultPropertyOption optionPropertyResult = 8;
    optional ResultPropertyKlineShape klineShapePropertyResult = 9;
}

message RspItem
{
    required int64 stockId = 1;
    repeated RspItemResult results = 2;
}

message S2C
{
    required bool lastPage = 1;
    required int32 allCount = 2;
    repeated RspItem dataList = 3;
}

message Response
{
    required int32 retType = 1 [default = -400];
    optional string retMsg = 2;
    optional int32 errCode = 3;
    optional S2C s2c = 4;
}

• 接口调用结果，结构参见 RetType

• 协议 ID

  3252

int stockScreen(QotStockScreen.Request req) onReply_StockScreen(FTAPI_Conn client, int nSerialNo, QotStockScreen.Response rsp)

• 介绍

  条件选股 V2

• 参数

message Boundary
{
    required double value = 1;
    optional bool includes = 2;     // 是否闭区间，默认 true
}

message Interval
{
    optional Boundary filterMin = 1;
    optional Boundary filterMax = 2;
}

// ===== 各类 PropertyXxx =====
message PropertyBasic         { required int32 name = 1; }
message PropertySimple        { required int32 name = 1; optional int32 unit = 2; }
message PropertyCumulative    {
    required int32 name = 1;
    required int32 days = 2;
    optional int32 periodAverage = 3;
    optional int32 unit = 4;
}
message PropertyFinancial     {
    required int32 name = 1;
    optional int32 term = 2;
    optional int32 year = 3;
    optional int32 duration = 4;
    optional int32 periodAverage = 5;
    optional int32 futureDuration = 6;
    optional int32 unit = 7;
}
message PropertyIndicator     {
    required int32 name = 1;
    optional int32 period = 2;
    repeated int32 indicatorParams = 3;
}
message PropertyFeatured      {
    required int32 name = 1;
    optional int32 period = 2;
    optional int32 rangePeriod = 3;
    optional int32 firstCustomParam = 4;
}
message PropertyBroker        {
    required int32 name = 1;
    optional int32 days = 2;
    optional string param = 3;
}
message PropertyOption        {
    required int32 name = 1;
    optional int32 period = 2;
    optional string param = 3;
}
message PropertyKlineShape    {
    required int32 name = 1;
    optional int32 period = 2;
}

// ===== 各类 QueryXxx =====
message SimpleFieldQuery
{
    required int32 simpleField = 1;
    repeated int32 screenValueList = 2;
}

message PlateInfo
{
    repeated string plateIdList = 1;
    optional string parentPlateId = 2;
}

message PlateQuery       { repeated PlateInfo plateList = 1; }

message SimplePropertyQuery
{
    required PropertySimple property = 1;
    optional Boundary filterMin = 2;
    optional Boundary filterMax = 3;
}

message CumulativePropertyQuery
{
    required PropertyCumulative property = 1;
    optional Boundary filterMin = 2;
    optional Boundary filterMax = 3;
    optional int32 continuousPeriod = 4;
}

message FinancialPropertyQuery
{
    required PropertyFinancial property = 1;
    optional Boundary filterMin = 2;
    optional Boundary filterMax = 3;
    optional int32 continuousPeriod = 4;
}

message IndicatorPositionalQuery
{
    required int32 firstIndicatorName = 1;
    required int32 periodType = 2;
    required int32 position = 3;
    optional int32 secondIndicator = 4;
    optional int32 secondValue = 5;
    repeated int32 firstIndicatorParams = 6;
    repeated int32 secondIndicatorParams = 7;
    optional int32 continuousPeriod = 8;
    repeated Interval intervals = 9;
}

message IndicatorPatternQuery
{
    required int32 name = 1;
    required int32 periodType = 2;
    optional int32 continuousPeriod = 3;
    optional bool isMatching = 4;
    repeated int32 subPatterns = 5;
}

message FeaturedPropertyQuery
{
    required PropertyFeatured property = 1;
    repeated Interval intervals = 2;
    repeated int32 valueSet = 3;
}

message BrokerHoldingsQuery
{
    required PropertyBroker property = 1;
    repeated Interval intervals = 2;
}

message KlineShapeQuery
{
    required PropertyKlineShape property = 1;
    repeated int32 valueSet = 2;
}

message OptionQuery
{
    required PropertyOption property = 1;
    repeated Interval intervals = 2;
}

// ===== 一条筛选条件 (oneof 多选一) =====
message ScreenQuery
{
    optional SimpleFieldQuery simpleFieldQuery = 1;
    optional PlateQuery plateQuery = 2;
    optional SimplePropertyQuery simplePropertyQuery = 3;
    optional CumulativePropertyQuery cumulativePropertyQuery = 4;
    optional FinancialPropertyQuery financialPropertyQuery = 5;
    optional IndicatorPositionalQuery indicatorPositionalQuery = 6;
    optional IndicatorPatternQuery indicatorPatternQuery = 7;
    optional FeaturedPropertyQuery featuredPropertyQuery = 8;
    optional BrokerHoldingsQuery brokerHoldingsQuery = 9;
    optional KlineShapeQuery klineShapeQuery = 10;
    optional OptionQuery optionQuery = 11;
}

// ===== 取回字段 =====
message RetrieveQuery
{
    optional PropertyBasic basicProperty = 1;
    optional PropertySimple simpleProperty = 2;
    optional PropertyCumulative cumulativeProperty = 3;
    optional PropertyFinancial financialProperty = 4;
    optional PropertyIndicator indicatorProperty = 5;
    optional PropertyFeatured featuredProperty = 6;
    optional PropertyBroker brokerProperty = 7;
    optional PropertyOption optionProperty = 8;
    optional PropertyKlineShape klineShapeProperty = 9;
}

// ===== 排序定义 =====
message Sort
{
    required int32 direction = 1;   // 1=ASC, 2=DESC, 3=ABS_ASC, 4=ABS_DESC
    optional PropertyBasic basicProperty = 2;
    optional PropertySimple simpleProperty = 3;
    optional PropertyCumulative cumulativeProperty = 4;
    optional PropertyFinancial financialProperty = 5;
    optional PropertyIndicator indicatorProperty = 6;
    optional PropertyFeatured featuredProperty = 7;
    optional PropertyBroker brokerProperty = 8;
    optional PropertyOption optionProperty = 9;
    optional PropertyKlineShape klineShapeProperty = 10;
}

message C2S
{
    repeated ScreenQuery filterList = 1;
    repeated RetrieveQuery retrieveList = 2;
    repeated int64 watchlistStockIds = 3;
    optional Sort sort = 4;             // 单字段排序
    optional int32 pageFrom = 5;
    optional int32 pageCount = 6;
    repeated Sort sortList = 7;         // 多字段排序，非空时优先于 sort
}

message Request
{
    required C2S c2s = 1;
}

• 返回

// 单条结果值: valueType=1 时取 sval, =2 取 ival, =3 取 aval, =4 取 dval
message ResultPropertyBasic
{
    required PropertyBasic property = 1;
    optional int32 valueType = 2;
    optional string sval = 3;
    optional int64 ival = 4;
    repeated int64 aval = 5;
    optional double dval = 6;
    optional string enumTypeName = 7;
    optional string enumName = 8;
}
// 其余 ResultPropertySimple / Cumulative / Financial / Indicator / Featured / Broker / Option / KlineShape
// 结构与 ResultPropertyBasic 相同，仅 property 类型不同。Financial 额外包含 endTime。

message RspItemResult
{
    optional ResultPropertyBasic basicPropertyResult = 1;
    optional ResultPropertySimple simplePropertyResult = 2;
    optional ResultPropertyCumulative cumulativePropertyResult = 3;
    optional ResultPropertyFinancial financialPropertyResult = 4;
    optional ResultPropertyIndicator indicatorPropertyResult = 5;
    optional ResultPropertyFeatured featuredPropertyResult = 6;
    optional ResultPropertyBroker brokerPropertyResult = 7;
    optional ResultPropertyOption optionPropertyResult = 8;
    optional ResultPropertyKlineShape klineShapePropertyResult = 9;
}

message RspItem
{
    required int64 stockId = 1;
    repeated RspItemResult results = 2;
}

message S2C
{
    required bool lastPage = 1;
    required int32 allCount = 2;
    repeated RspItem dataList = 3;
}

message Response
{
    required int32 retType = 1 [default = -400];
    optional string retMsg = 2;
    optional int32 errCode = 3;
    optional S2C s2c = 4;
}

• 接口调用结果，结构参见 RetType

• 协议 ID

  3252

bool StockScreen(uint32_t & nSerialNo, const Qot_StockScreen::Request & stReq); virtual void OnReply_StockScreen(FTAPI_Conn* pConn, uint32_t nSerialNo, const Qot_StockScreen::Response & stRsp)

• 介绍

  条件选股 V2

• 参数

message Boundary
{
    required double value = 1;
    optional bool includes = 2;     // 是否闭区间，默认 true
}

message Interval
{
    optional Boundary filterMin = 1;
    optional Boundary filterMax = 2;
}

// ===== 各类 PropertyXxx =====
message PropertyBasic         { required int32 name = 1; }
message PropertySimple        { required int32 name = 1; optional int32 unit = 2; }
message PropertyCumulative    {
    required int32 name = 1;
    required int32 days = 2;
    optional int32 periodAverage = 3;
    optional int32 unit = 4;
}
message PropertyFinancial     {
    required int32 name = 1;
    optional int32 term = 2;
    optional int32 year = 3;
    optional int32 duration = 4;
    optional int32 periodAverage = 5;
    optional int32 futureDuration = 6;
    optional int32 unit = 7;
}
message PropertyIndicator     {
    required int32 name = 1;
    optional int32 period = 2;
    repeated int32 indicatorParams = 3;
}
message PropertyFeatured      {
    required int32 name = 1;
    optional int32 period = 2;
    optional int32 rangePeriod = 3;
    optional int32 firstCustomParam = 4;
}
message PropertyBroker        {
    required int32 name = 1;
    optional int32 days = 2;
    optional string param = 3;
}
message PropertyOption        {
    required int32 name = 1;
    optional int32 period = 2;
    optional string param = 3;
}
message PropertyKlineShape    {
    required int32 name = 1;
    optional int32 period = 2;
}

// ===== 各类 QueryXxx =====
message SimpleFieldQuery
{
    required int32 simpleField = 1;
    repeated int32 screenValueList = 2;
}

message PlateInfo
{
    repeated string plateIdList = 1;
    optional string parentPlateId = 2;
}

message PlateQuery       { repeated PlateInfo plateList = 1; }

message SimplePropertyQuery
{
    required PropertySimple property = 1;
    optional Boundary filterMin = 2;
    optional Boundary filterMax = 3;
}

message CumulativePropertyQuery
{
    required PropertyCumulative property = 1;
    optional Boundary filterMin = 2;
    optional Boundary filterMax = 3;
    optional int32 continuousPeriod = 4;
}

message FinancialPropertyQuery
{
    required PropertyFinancial property = 1;
    optional Boundary filterMin = 2;
    optional Boundary filterMax = 3;
    optional int32 continuousPeriod = 4;
}

message IndicatorPositionalQuery
{
    required int32 firstIndicatorName = 1;
    required int32 periodType = 2;
    required int32 position = 3;
    optional int32 secondIndicator = 4;
    optional int32 secondValue = 5;
    repeated int32 firstIndicatorParams = 6;
    repeated int32 secondIndicatorParams = 7;
    optional int32 continuousPeriod = 8;
    repeated Interval intervals = 9;
}

message IndicatorPatternQuery
{
    required int32 name = 1;
    required int32 periodType = 2;
    optional int32 continuousPeriod = 3;
    optional bool isMatching = 4;
    repeated int32 subPatterns = 5;
}

message FeaturedPropertyQuery
{
    required PropertyFeatured property = 1;
    repeated Interval intervals = 2;
    repeated int32 valueSet = 3;
}

message BrokerHoldingsQuery
{
    required PropertyBroker property = 1;
    repeated Interval intervals = 2;
}

message KlineShapeQuery
{
    required PropertyKlineShape property = 1;
    repeated int32 valueSet = 2;
}

message OptionQuery
{
    required PropertyOption property = 1;
    repeated Interval intervals = 2;
}

// ===== 一条筛选条件 (oneof 多选一) =====
message ScreenQuery
{
    optional SimpleFieldQuery simpleFieldQuery = 1;
    optional PlateQuery plateQuery = 2;
    optional SimplePropertyQuery simplePropertyQuery = 3;
    optional CumulativePropertyQuery cumulativePropertyQuery = 4;
    optional FinancialPropertyQuery financialPropertyQuery = 5;
    optional IndicatorPositionalQuery indicatorPositionalQuery = 6;
    optional IndicatorPatternQuery indicatorPatternQuery = 7;
    optional FeaturedPropertyQuery featuredPropertyQuery = 8;
    optional BrokerHoldingsQuery brokerHoldingsQuery = 9;
    optional KlineShapeQuery klineShapeQuery = 10;
    optional OptionQuery optionQuery = 11;
}

// ===== 取回字段 =====
message RetrieveQuery
{
    optional PropertyBasic basicProperty = 1;
    optional PropertySimple simpleProperty = 2;
    optional PropertyCumulative cumulativeProperty = 3;
    optional PropertyFinancial financialProperty = 4;
    optional PropertyIndicator indicatorProperty = 5;
    optional PropertyFeatured featuredProperty = 6;
    optional PropertyBroker brokerProperty = 7;
    optional PropertyOption optionProperty = 8;
    optional PropertyKlineShape klineShapeProperty = 9;
}

// ===== 排序定义 =====
message Sort
{
    required int32 direction = 1;   // 1=ASC, 2=DESC, 3=ABS_ASC, 4=ABS_DESC
    optional PropertyBasic basicProperty = 2;
    optional PropertySimple simpleProperty = 3;
    optional PropertyCumulative cumulativeProperty = 4;
    optional PropertyFinancial financialProperty = 5;
    optional PropertyIndicator indicatorProperty = 6;
    optional PropertyFeatured featuredProperty = 7;
    optional PropertyBroker brokerProperty = 8;
    optional PropertyOption optionProperty = 9;
    optional PropertyKlineShape klineShapeProperty = 10;
}

message C2S
{
    repeated ScreenQuery filterList = 1;
    repeated RetrieveQuery retrieveList = 2;
    repeated int64 watchlistStockIds = 3;
    optional Sort sort = 4;             // 单字段排序
    optional int32 pageFrom = 5;
    optional int32 pageCount = 6;
    repeated Sort sortList = 7;         // 多字段排序，非空时优先于 sort
}

message Request
{
    required C2S c2s = 1;
}

• 返回

// 单条结果值: valueType=1 时取 sval, =2 取 ival, =3 取 aval, =4 取 dval
message ResultPropertyBasic
{
    required PropertyBasic property = 1;
    optional int32 valueType = 2;
    optional string sval = 3;
    optional int64 ival = 4;
    repeated int64 aval = 5;
    optional double dval = 6;
    optional string enumTypeName = 7;
    optional string enumName = 8;
}
// 其余 ResultPropertySimple / Cumulative / Financial / Indicator / Featured / Broker / Option / KlineShape
// 结构与 ResultPropertyBasic 相同，仅 property 类型不同。Financial 额外包含 endTime。

message RspItemResult
{
    optional ResultPropertyBasic basicPropertyResult = 1;
    optional ResultPropertySimple simplePropertyResult = 2;
    optional ResultPropertyCumulative cumulativePropertyResult = 3;
    optional ResultPropertyFinancial financialPropertyResult = 4;
    optional ResultPropertyIndicator indicatorPropertyResult = 5;
    optional ResultPropertyFeatured featuredPropertyResult = 6;
    optional ResultPropertyBroker brokerPropertyResult = 7;
    optional ResultPropertyOption optionPropertyResult = 8;
    optional ResultPropertyKlineShape klineShapePropertyResult = 9;
}

message RspItem
{
    required int64 stockId = 1;
    repeated RspItemResult results = 2;
}

message S2C
{
    required bool lastPage = 1;
    required int32 allCount = 2;
    repeated RspItem dataList = 3;
}

message Response
{
    required int32 retType = 1 [default = -400];
    optional string retMsg = 2;
    optional int32 errCode = 3;
    optional S2C s2c = 4;
}

• 接口调用结果，结构参见 RetType

• 协议 ID

  3252

GetStockScreen(req);

• 介绍

  条件选股 V2

• 参数

message Boundary
{
    required double value = 1;
    optional bool includes = 2;     // 是否闭区间，默认 true
}

message Interval
{
    optional Boundary filterMin = 1;
    optional Boundary filterMax = 2;
}

// ===== 各类 PropertyXxx =====
message PropertyBasic         { required int32 name = 1; }
message PropertySimple        { required int32 name = 1; optional int32 unit = 2; }
message PropertyCumulative    {
    required int32 name = 1;
    required int32 days = 2;
    optional int32 periodAverage = 3;
    optional int32 unit = 4;
}
message PropertyFinancial     {
    required int32 name = 1;
    optional int32 term = 2;
    optional int32 year = 3;
    optional int32 duration = 4;
    optional int32 periodAverage = 5;
    optional int32 futureDuration = 6;
    optional int32 unit = 7;
}
message PropertyIndicator     {
    required int32 name = 1;
    optional int32 period = 2;
    repeated int32 indicatorParams = 3;
}
message PropertyFeatured      {
    required int32 name = 1;
    optional int32 period = 2;
    optional int32 rangePeriod = 3;
    optional int32 firstCustomParam = 4;
}
message PropertyBroker        {
    required int32 name = 1;
    optional int32 days = 2;
    optional string param = 3;
}
message PropertyOption        {
    required int32 name = 1;
    optional int32 period = 2;
    optional string param = 3;
}
message PropertyKlineShape    {
    required int32 name = 1;
    optional int32 period = 2;
}

// ===== 各类 QueryXxx =====
message SimpleFieldQuery
{
    required int32 simpleField = 1;
    repeated int32 screenValueList = 2;
}

message PlateInfo
{
    repeated string plateIdList = 1;
    optional string parentPlateId = 2;
}

message PlateQuery       { repeated PlateInfo plateList = 1; }

message SimplePropertyQuery
{
    required PropertySimple property = 1;
    optional Boundary filterMin = 2;
    optional Boundary filterMax = 3;
}

message CumulativePropertyQuery
{
    required PropertyCumulative property = 1;
    optional Boundary filterMin = 2;
    optional Boundary filterMax = 3;
    optional int32 continuousPeriod = 4;
}

message FinancialPropertyQuery
{
    required PropertyFinancial property = 1;
    optional Boundary filterMin = 2;
    optional Boundary filterMax = 3;
    optional int32 continuousPeriod = 4;
}

message IndicatorPositionalQuery
{
    required int32 firstIndicatorName = 1;
    required int32 periodType = 2;
    required int32 position = 3;
    optional int32 secondIndicator = 4;
    optional int32 secondValue = 5;
    repeated int32 firstIndicatorParams = 6;
    repeated int32 secondIndicatorParams = 7;
    optional int32 continuousPeriod = 8;
    repeated Interval intervals = 9;
}

message IndicatorPatternQuery
{
    required int32 name = 1;
    required int32 periodType = 2;
    optional int32 continuousPeriod = 3;
    optional bool isMatching = 4;
    repeated int32 subPatterns = 5;
}

message FeaturedPropertyQuery
{
    required PropertyFeatured property = 1;
    repeated Interval intervals = 2;
    repeated int32 valueSet = 3;
}

message BrokerHoldingsQuery
{
    required PropertyBroker property = 1;
    repeated Interval intervals = 2;
}

message KlineShapeQuery
{
    required PropertyKlineShape property = 1;
    repeated int32 valueSet = 2;
}

message OptionQuery
{
    required PropertyOption property = 1;
    repeated Interval intervals = 2;
}

// ===== 一条筛选条件 (oneof 多选一) =====
message ScreenQuery
{
    optional SimpleFieldQuery simpleFieldQuery = 1;
    optional PlateQuery plateQuery = 2;
    optional SimplePropertyQuery simplePropertyQuery = 3;
    optional CumulativePropertyQuery cumulativePropertyQuery = 4;
    optional FinancialPropertyQuery financialPropertyQuery = 5;
    optional IndicatorPositionalQuery indicatorPositionalQuery = 6;
    optional IndicatorPatternQuery indicatorPatternQuery = 7;
    optional FeaturedPropertyQuery featuredPropertyQuery = 8;
    optional BrokerHoldingsQuery brokerHoldingsQuery = 9;
    optional KlineShapeQuery klineShapeQuery = 10;
    optional OptionQuery optionQuery = 11;
}

// ===== 取回字段 =====
message RetrieveQuery
{
    optional PropertyBasic basicProperty = 1;
    optional PropertySimple simpleProperty = 2;
    optional PropertyCumulative cumulativeProperty = 3;
    optional PropertyFinancial financialProperty = 4;
    optional PropertyIndicator indicatorProperty = 5;
    optional PropertyFeatured featuredProperty = 6;
    optional PropertyBroker brokerProperty = 7;
    optional PropertyOption optionProperty = 8;
    optional PropertyKlineShape klineShapeProperty = 9;
}

// ===== 排序定义 =====
message Sort
{
    required int32 direction = 1;   // 1=ASC, 2=DESC, 3=ABS_ASC, 4=ABS_DESC
    optional PropertyBasic basicProperty = 2;
    optional PropertySimple simpleProperty = 3;
    optional PropertyCumulative cumulativeProperty = 4;
    optional PropertyFinancial financialProperty = 5;
    optional PropertyIndicator indicatorProperty = 6;
    optional PropertyFeatured featuredProperty = 7;
    optional PropertyBroker brokerProperty = 8;
    optional PropertyOption optionProperty = 9;
    optional PropertyKlineShape klineShapeProperty = 10;
}

message C2S
{
    repeated ScreenQuery filterList = 1;
    repeated RetrieveQuery retrieveList = 2;
    repeated int64 watchlistStockIds = 3;
    optional Sort sort = 4;             // 单字段排序
    optional int32 pageFrom = 5;
    optional int32 pageCount = 6;
    repeated Sort sortList = 7;         // 多字段排序，非空时优先于 sort
}

message Request
{
    required C2S c2s = 1;
}

• 返回

// 单条结果值: valueType=1 时取 sval, =2 取 ival, =3 取 aval, =4 取 dval
message ResultPropertyBasic
{
    required PropertyBasic property = 1;
    optional int32 valueType = 2;
    optional string sval = 3;
    optional int64 ival = 4;
    repeated int64 aval = 5;
    optional double dval = 6;
    optional string enumTypeName = 7;
    optional string enumName = 8;
}
// 其余 ResultPropertySimple / Cumulative / Financial / Indicator / Featured / Broker / Option / KlineShape
// 结构与 ResultPropertyBasic 相同，仅 property 类型不同。Financial 额外包含 endTime。

message RspItemResult
{
    optional ResultPropertyBasic basicPropertyResult = 1;
    optional ResultPropertySimple simplePropertyResult = 2;
    optional ResultPropertyCumulative cumulativePropertyResult = 3;
    optional ResultPropertyFinancial financialPropertyResult = 4;
    optional ResultPropertyIndicator indicatorPropertyResult = 5;
    optional ResultPropertyFeatured featuredPropertyResult = 6;
    optional ResultPropertyBroker brokerPropertyResult = 7;
    optional ResultPropertyOption optionPropertyResult = 8;
    optional ResultPropertyKlineShape klineShapePropertyResult = 9;
}

message RspItem
{
    required int64 stockId = 1;
    repeated RspItemResult results = 2;
}

message S2C
{
    required bool lastPage = 1;
    required int32 allCount = 2;
    repeated RspItem dataList = 3;
}

message Response
{
    required int32 retType = 1 [default = -400];
    optional string retMsg = 2;
    optional int32 errCode = 3;
    optional S2C s2c = 4;
}

• 接口调用结果，结构参见 RetType

• 协议 ID

  3252

• Example

import mmWebsocket from "moomoo-api";
import { Common, Qot_Common } from "moomoo-api/proto";
import beautify from "js-beautify";

function QotGetStockScreen(){
    const { RetType } = Common
    // SimpleField / ScrMarket / SimpleProperty 为数值常量，完整列表见 quote.md「筛选 V2」；下同
    let [addr, port, enable_ssl, key] = ["127.0.0.1", 33333, false, '7522027ccf5a06b1'];
    let websocket = new mmWebsocket();

    websocket.onlogin = (ret, msg)=>{
        if (ret) {
            // 港股最新价 >= 10、市值 >= 100 亿，按市值降序取回代码/名称/价格/市值
            const req = {
                c2s: {
                    filterList: [
                        { simpleFieldQuery: { simpleField: 1 /* SimpleField.MARKET 市场 */, screenValueList: [1 /* ScrMarket.HK */] } },
                        { simplePropertyQuery: { property: { name: 2201 /* SimpleProperty.PRICE */ }, filterMin: { value: 10, includes: true } } },
                        { simplePropertyQuery: { property: { name: 2301 /* SimpleProperty.MARKET_CAP */ }, filterMin: { value: 10000000000, includes: true } } }
                    ],
                    retrieveList: [
                        { basicProperty: { name: 1101 } },
                        { basicProperty: { name: 1102 } },
                        { simpleProperty: { name: 2201 /* SimpleProperty.PRICE */ } },
                        { simpleProperty: { name: 2301 /* SimpleProperty.MARKET_CAP */ } }
                    ],
                    sort: { direction: 2, simpleProperty: { name: 2301 /* SimpleProperty.MARKET_CAP */ } },
                    pageFrom: 0,
                    pageCount: 5,
                },
            };
            websocket.GetStockScreen(req)
            .then((res)=>{
                let { errCode, retMsg, retType, s2c } = res
                console.log("GetStockScreen: errCode %d, retMsg %s, retType %d", errCode, retMsg, retType);
                if(retType == RetType.RetType_Succeed){
                    let data = beautify(JSON.stringify(s2c), { indent_size: 2, space_in_empty_paren: true });
                    console.log(data);
                }
            })
            .catch((error)=>{ console.log("error:", error); });
        } else {
            console.log("start error", msg);
        }
    };

    websocket.start(addr, port, enable_ssl, key);
    setTimeout(()=>{ websocket.stop(); process.exit(); }, 5000);
}

QotGetStockScreen()

• Output

GetStockScreen: errCode 0, retMsg , retType 0
{
  "lastPage": true,
  "allCount": 1,
  "dataList": [
    {
      "stockId": "54047868453564",
      "results": [
        { "basicPropertyResult": { "property": { "name": 1101 }, "valueType": 1, "sval": "00700" } },
        { "basicPropertyResult": { "property": { "name": 1102 }, "valueType": 1, "sval": "腾讯控股" } },
        { "simplePropertyResult": { "property": { "name": 2201 }, "valueType": 4, "dval": 460.0 } },
        { "simplePropertyResult": { "property": { "name": 2301 }, "valueType": 4, "dval": 4194280264040.0 } }
      ]
    }
  ]
}

接口限制

• 每 30 秒内最多请求 10 次条件选股接口