股票筛选
POST/api/v1.0/quote/stock-screen条件选股:组合 N 个筛选条件对全市场标的过滤、排序、分页,并按指定取值因子返回每只命中标的的多个列。窝轮筛选请用 warrant-screen;期权筛选请用 option-screen。
请求参数
| 参数 | 类型 | 位置 | 必填 | 说明 |
|---|---|---|---|---|
screen_queries | object[] | 请求体 | 是 | 筛选条件数组,每元素是「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_queries | object[] | 请求体 | 否 | 取值因子数组,每元素是「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 |
sort | object | 请求体 | 否 | 单字段排序(与 sorts 二选一,sorts 优先)。结构 {direction, simple_property:{name}}(也可换成 cumulative_property / financial_property / featured_property)。direction:1=升序,2=降序,3=按绝对值升序,4=按绝对值降序。 |
sorts | object[] | 请求体 | 否 | 排序字段列表,按数组顺序分主次。 最多项数 10000 |
next_key | string | 请求体 | 否 | 翻页游标,首页留空。 最长长度 1000; 格式 ^$|^(-?[0-9]+)?$ |
limit | int | 请求体 | 否 | 单页条数。 ≤ 300; 默认 200 |
watchlist_stock_ids | int[] | 请求体 | 否 | 自选股 stock_id 列表,仅在自选范围内筛选时传入。 最多项数 10000 |
holding_stock_ids | int[] | 请求体 | 否 | 持仓 stock_id 列表,仅在持仓范围内筛选时传入。 最多项数 10000 |
user_stock_list_mode | int | 请求体 | 否 | 筛选范围: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响应字段
| 参数 | 类型 | 说明 |
|---|---|---|
data | object | |
data.items | object[] | |
data.items[].code | string | 标的代码(含市场前缀),例: HK.00700 |
data.items[].name | string | 标的英文名,例: TENCENT |
data.items[].sc_name | string | 标的简体中文名,例: 腾讯控股 |
data.items[].tc_name | string | 标的繁体中文名,例: 騰訊控股 |
data.items[].results | object[] | 该标的对应每个 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"}}] |
pagination | object | |
pagination.total | int | |
pagination.has_more | bool | |
pagination.next_key | string |
限制范围
- 支持市场: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_code | error.code | 触发条件 | 处理建议 |
|---|---|---|---|
| -3 | invalid_parameter | 缺必填 screen_queries;limit > 300;next_key 非法;user_stock_list_mode 取值不在 {0,1,2} 内;其它字段类型错误。 | 校正请求体后重试。 |
| -5 | internal_error | 服务错误 | 检查 query 结构与 property name / market 值的合法性后重试。 |
| -6 | internal_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
}
}