Skip to content

股票筛选 ​

POST /api/v1.0/quote/stock-screen

条件选股:组合 N 个筛选条件对全市场标的过滤、排序、分页,并按指定取值因子返回每只命中标的的多个列。窝轮筛选请用 warrant-screen;期权筛选请用 option-screen。

请求参数 ​

参数类型位置必填说明
screen_queriesobject[]请求体是筛选条件数组,每元素是「11 选 1」的 query 对象——simple_field_query(市场/交易所/指数/北向板块等枚举字段 IN 列表)/ plate_query(板块筛选)/ simple_property_query(行情·估值因子区间)/ cumulative_property_query(累计行情区间,需带周期)/ financial_property_query(财务因子区间,需带财报期)/ indicator_positional_query(技术指标位置关系)/ indicator_pattern_query(技术形态)/ featured_property_query(特色因子)/ broker_holdings_query(经纪商持股,仅 HK)/ kline_shape_query(K 线形态)/ option_query(期权指标)。区间用 lower={value, includes} / upper={value, includes},value 已按字段倍率预放大。 最少项数 1; 最多项数 10000
retrieve_queriesobject[]请求体否取值因子数组,每元素是「9 选 1」的 retrieve 对象——basic_property / simple_property / cumulative_property / financial_property / featured_property / indicator_property / broker_property / kline_shape_property / option_property。返回顺序与 retrieve_queries 完全对齐。 最多项数 10000
sortobject请求体否单字段排序(与 sorts 二选一,sorts 优先)。结构 {direction, simple_property:{name}}(也可换成 cumulative_property / financial_property / featured_property)。direction:1=升序,2=降序,3=按绝对值升序,4=按绝对值降序。
sortsobject[]请求体否排序字段列表,按数组顺序分主次。 最多项数 10000
next_keystring请求体否翻页游标,首页留空。 最长长度 1000; 格式 ^$|^(-?[0-9]+)?$
limitint请求体否单页条数。 ≤ 300; 默认 200
watchlist_stock_idsint[]请求体否自选股 stock_id 列表,仅在自选范围内筛选时传入。 最多项数 10000
holding_stock_idsint[]请求体否持仓 stock_id 列表,仅在持仓范围内筛选时传入。 最多项数 10000
user_stock_list_modeint请求体否筛选范围:0 不限制,1 仅自选,2 仅持仓。 取值 0, 1, 2

请求示例 ​

bash
curl -X POST "https://webapi.futunn.com/api/v1.0/quote/stock-screen" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <AccessToken>" \
  -d '{"limit":3,"screen_queries":[{"simple_field_query":{"simple_field":1,"screen_value_list":[1]}}],"retrieve_queries":[{"simple_property":{"name":2201}},{"simple_property":{"name":2301}},{"simple_property":{"name":2303}}],"sort":{"direction":2,"simple_property":{"name":2301}}}' | jq

响应字段 ​

参数类型说明
dataobject
data.itemsobject[]
data.items[].codestring标的代码(含市场前缀),例: HK.00700
data.items[].namestring标的英文名,例: TENCENT
data.items[].sc_namestring标的简体中文名,例: 腾讯控股
data.items[].tc_namestring标的繁体中文名,例: 騰訊控股
data.items[].resultsobject[]该标的对应每个 retrieve_queries 因子的取值结果,含 basic_property_result / simple_property_result / financial_property_result 等。res.ival 为整数原始值(含倍率),result_type=2 表示 int。倍率规则: 倍数类(PE/PB/PS/PCF/量比/BETA) ×1e5、价格/涨跌额 ×1000、市值/成交额 ×1000;百分比类(涨跌幅/振幅/换手率/股息率/各类增长率·利润率·收益率·持股比例等) 一律 ×1e3(即返回值=百分数×1000,÷1e3 还原百分数)。例: [{simple_property_result:{property:{name:2201}, res:{ival:"505000", result_type:2}, value:"505000"}}]
paginationobject
pagination.totalint
pagination.has_morebool
pagination.next_keystring

限制范围 ​

  • 支持市场:HK 港股 / US 美股 / CN A 股 / SG 新加坡 / CA 加拿大 / AU 澳大利亚 / JA 日本 / MY 马来西亚 / KR 韩国暂不支持。
  • 支持品类:正股 / ETF / 指数 / REIT 等可在筛选范围内的标的;窝轮请用 warrant-screen,期权请用 option-screen。
  • broker_holdings_query / kline_shape_query 仅 HK 市场可用;option_query 需标的有期权。
  • 单页 limit 最大 300;next_key 为不透明游标。
  • 合法但无命中(过严筛选、或传入不支持的市场等)返回 ret_code=0 + data.items=[] + pagination.total=0,空结果集是成功而非错误。

错误码 ​

ret_codeerror.code触发条件处理建议
-3invalid_parameter缺必填 screen_queries;limit > 300;next_key 非法;user_stock_list_mode 取值不在 {0,1,2} 内;其它字段类型错误。校正请求体后重试。
-5internal_error服务错误检查 query 结构与 property name / market 值的合法性后重试。
-6internal_error服务错误联系 技术支持排查。

响应示例 ​

json
{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "items": [
      {
        "code": "HK.05432",
        "name": "...",
        "sc_name": "...",
        "tc_name": "...",
        "results": []
      },
      {
        "code": "HK.00700",
        "name": "TENCENT",
        "sc_name": "腾讯控股",
        "tc_name": "騰訊控股",
        "results": []
      }
    ]
  },
  "pagination": {
    "has_more": true,
    "next_key": "3",
    "total": 2938
  }
}