股票历史选股（screening）接口文档

历史选股线路，仅查询 90 本地已保存的盘后指标；不传日期时使用最近已保存的交易日。支持单日、区间、筛选、排序和分页。权限沿用实时 screening：免费、体验、专业、旗舰开放，标准版不开放；金额为元。基础资料与元数据使用最近盘后同步结果。

请求参数

• apiname（string（screening），必选）：固定接口名称，用于选择对应的数据能力。
• apikey（string，必选）：猫爪数据 API Key。网页在线调试会为已登录用户自动注入，其他调用请从控制台获取。
• fields（string|null，可选）：需要返回的字段列表，多个字段使用英文逗号分隔；可选字段见下方返回字段表。
• params（object，可选）：查询条件对象；具体参数、格式和互斥关系见下方 params 参数表。
• symbols（string|array<string>，可选）：股票代码，支持单个、多个逗号分隔或数组；不传则默认全市场标的。
• tradedate（string，可选）：查询单个交易日，格式：YYYYMMDD；不能与 startdate/enddate 同时传。不传 tradedate 时默认最新交易日。
• startdate（string，可选）：查询区间开始日期，格式：YYYYMMDD；仅传该参数时查询至最新交易日。
• enddate（string，可选）：查询区间结束日期，格式：YYYYMMDD；仅传该参数时按该交易日查询。
• recentdays（integer，可选）：最近 N 个交易日覆盖的日期区间。不能与 tradedate/startdate/enddate 同时传。
• tradedate_offset（integer，可选）：相对最新交易日的单日偏移，0 表示最新交易日，-1 表示上一交易日。

返回字段

• tradedate（string）：日期格式：YYYYMMDD。
• symbol（string）：6 位股票代码。
• name（string|null）：股票简称。
• open（number|null）：当前周期的开盘价。
• high（number|null）：当前周期的最高价。
• low（number|null）：当前周期的最低价。
• close（number|null）：最新交易日盘中为最新价，历史周期为收盘价。
• pre_close（number|null）：前复权可比昨收价；最新交易日作为实时涨幅基准价。
• change（number|null）：收盘价或最新价与昨收价之差。
• pct_chg（number|null）：相对昨收价的涨跌幅。
• vol（number|null）：当前周期的累计成交量。
• amount（number|null）：当前周期的累计成交金额。
• up_limit（number|null）：当日涨停价格。
• down_limit（number|null）：当日跌停价格。
• is_st（string|boolean|null）：是否 ST
• turnover_rate_f（number|null）：实际换手率（%）
• volume_ratio（number|null）：量比
• free_float_mv（number|null）：自由流通市值（元）
• circ_mv（number|null）：流通市值（元）
• total_mv（number|null）：总市值（元）
• type（string|null）：u=涨停、d=跌停、ub=涨停炸板、db=跌停炸板。
• is_break（boolean|null）：true 表示炸板，false 表示未炸板。
• limit_times（integer|null）：涨停为正、跌停为负、非封板为 0。
• pre_limit_times（integer|null）：方向符号与 limit_times 相同；无有效前日时返回 null。
• fd_amount（number|null）：封单额（元）：涨停取买一、跌停取卖一，非封板或盘口无效返回 null。
• pre_fd_amount（number|null）：昨日封单额（元）
• prev_fd_amount（number|null）：前日封单额（元）
• fd_to_turnover（number|null）：封成比
• fd_to_yesterday（number|null）：封昨比
• first_time（string|null）：格式：HH:mm:ss。
• last_time（string|null）：格式：HH:mm:ss。
• m_price（number|null）：竞价撮合价
• auc_pct_chg（number|null）：竞价涨幅（%）
• auc_net_amount（number|null）：竞价净额（元）
• auc_amt（number|null）：竞价成交额（元）
• auc_vol（number|null）：竞价成交量（手）
• auc_turnover（number|null）：真实竞价换手率（%）
• ztwme（number|null）：涨停委买额（元）
• ztwme20（number|null）：20分后涨停委买额（元）
• fa_0915（number|null）：0915 封单额（元）
• fa_0920f（number|null）：20分后封单额（元）
• fa_0925l（number|null）：开盘封单额（元）
• theme_names_xgb（string|null）：选股宝题材
• theme_names_kpl（string|null）：开盘啦题材
• theme_names_jygs（string|null）：韭菜公社题材
• reason_xgb（string|null）：选股宝涨停原因
• reason_kpl（string|null）：开盘啦涨停原因
• reason_jygs（string|null）：韭菜公社涨停原因
• reason_main_kpl（string|null）：开盘啦关键因素
• reason_main_jygs（string|null）：韭菜公社关键因素
• hot_ths_normal_rank（integer|null）：同花顺热股榜排名。
• hot_dfcf_biaos_rank（integer|null）：东方财富飙升榜排名。
• hot_xq_resou_rank（integer|null）：雪球热搜榜排名。
• hot_tdx_resou_rank（integer|null）：通达信热搜榜排名。
• code（string|null）：含交易所后缀的当前证券代码；历史查询补充当前基础资料，不表示该日的证券资料快照。缺失返回 null。
• area（string|null）：股票当前地域；历史查询补充当前基础资料。缺失返回 null。
• market（string|null）：股票当前上市板块，如主板、创业板、科创板、北交所或 CDR；历史查询补充当前基础资料。缺失返回 null。
• pre_pct_chg（number|null）：所查询交易日的上一交易日涨跌幅；百分数值，1.25 表示 1.25%。实时预加载对停复牌股票可取此前最近可用行情；历史查询读取该日已保存指标。缺失返回 null。
• pre_amount（number|null）：所查询交易日的上一交易日全天成交额，接口统一为元，底层千元值乘以 1000 后返回。实时预加载对停复牌股票可取此前最近可用行情；历史查询读取该日已保存指标。缺失返回 null。
• pre_vol（number|null）：所查询交易日的上一交易日全天成交量，接口统一为手。实时预加载对停复牌股票可取此前最近可用行情；历史查询读取该日已保存指标。缺失返回 null。
• prev_turnover_rate_f（number|null）：所查询交易日的上一交易日实际换手率，与 turnover_rate_f 使用相同口径；百分数值。实时预加载对停复牌股票可取此前最近可用基础指标；历史查询读取该日已保存指标。缺失返回 null。
• auc_vol_ratio（number|null）：竞价成交量 ÷ 前五个交易日平均每分钟成交量；分母为五日总成交量 ÷ (5 × 240)。实时 09:25 前以买一匹配量计算，09:25 后使用竞价成交量；缺少分母或分母为零返回 null。
• pre_auc_vol（number|null）：所查询交易日的上一交易日竞价成交量，单位手。缺失返回 null。
• auc_to_pre_vol_pct（number|null）：今日竞价成交量 ÷ pre_vol × 100；分子、分母使用相同单位，pre_vol 通常为上一交易日成交量，停复牌的实时预加载可能使用最近可用行情。缺少参考量或分母为零返回 null。
• auc_to_pre_auc_vol_ratio（number|null）：今日竞价成交量 ÷ 上一交易日竞价成交量，为倍数值。缺少参考量或分母为零返回 null。
• um_vol（number|null）：竞价盘口买二与卖二未匹配量中的较大值，单位手；不表示买卖方向。盘口缺失返回 null，真实零保留为 0。
• pre_type（string|null）：所查询交易日的上一交易日涨跌停池类型；u/u1/u1n/ul 表示涨停相关类型，d=跌停、ub=涨停炸板、db=跌停炸板、bu=大涨、bd=大跌。不适用或缺失返回 null。
• open_times（integer|null）：当日封住涨停或跌停后被打开的次数；真实零保留为 0，不适用或数据缺失返回 null。
• limit_type（integer|null）：板型编码：1=一字板、2=T字涨停、3=反包涨停、4=换手板、5=天地板、6=地天板、7=其他跌停、9=反包跌停。编码 8 被现有算法复用：涨停方向表示其他涨停，跌停方向表示 T字跌停，须结合 type 判断；缺失或无有效板型返回 null。
• main_net_amount（number|null）：开盘啦个股资金来源，所查询交易日全天累计（盘中截至最新更新）主力买卖净额，单位元；正值为净流入，负值为净流出。竞价主力净额与 auc_net_amount 为不同来源/口径，不可互换。缺失或源异常返回 null，真实零保留为 0。
• pre_main_net_amount（number|null）：开盘啦个股资金来源，所查询交易日的上一交易日全天累计（盘中截至最新更新）主力买卖净额，单位元；正值为净流入，负值为净流出。竞价主力净额与 auc_net_amount 为不同来源/口径，不可互换。缺失或源异常返回 null，真实零保留为 0。
• auction_main_net_amount（number|null）：开盘啦个股资金来源，所查询交易日竞价阶段主力买卖净额，单位元；正值为净流入，负值为净流出。竞价主力净额与 auc_net_amount 为不同来源/口径，不可互换。缺失或源异常返回 null，真实零保留为 0。
• pre_auction_main_net_amount（number|null）：开盘啦个股资金来源，所查询交易日的上一交易日竞价阶段主力买卖净额，单位元；正值为净流入，负值为净流出。竞价主力净额与 auc_net_amount 为不同来源/口径，不可互换。缺失或源异常返回 null，真实零保留为 0。
• theme_symbols_xgb（string|null）：选股宝来源的当日涨停题材代码，多个代码使用英文逗号分隔；代码仅在本来源内解释。无有效题材返回 null。
• latest_theme_symbols_xgb（string|null）：以所查询交易日为基准，近 180 个交易日最近一次有效涨停的选股宝题材代码；多个代码使用英文逗号分隔。无有效历史题材返回 null。
• latest_theme_names_xgb（string|null）：以所查询交易日为基准，近 180 个交易日最近一次有效涨停的选股宝题材名称，与同来源近期题材代码取自同一历史记录；多个名称使用英文逗号分隔。名称缺失返回 null。
• theme_symbols_kpl（string|null）：开盘啦来源的当日涨停题材代码，多个代码使用英文逗号分隔；代码仅在本来源内解释。无有效题材返回 null。
• latest_theme_symbols_kpl（string|null）：以所查询交易日为基准，近 180 个交易日最近一次有效涨停的开盘啦题材代码；多个代码使用英文逗号分隔。无有效历史题材返回 null。
• latest_theme_names_kpl（string|null）：以所查询交易日为基准，近 180 个交易日最近一次有效涨停的开盘啦题材名称，与同来源近期题材代码取自同一历史记录；多个名称使用英文逗号分隔。名称缺失返回 null。
• theme_symbols_jygs（string|null）：韭菜公社来源的当日涨停题材代码，多个代码使用英文逗号分隔；代码仅在本来源内解释。无有效题材返回 null。
• latest_theme_symbols_jygs（string|null）：以所查询交易日为基准，近 180 个交易日最近一次有效涨停的韭菜公社题材代码；多个代码使用英文逗号分隔。无有效历史题材返回 null。
• latest_theme_names_jygs（string|null）：以所查询交易日为基准，近 180 个交易日最近一次有效涨停的韭菜公社题材名称，与同来源近期题材代码取自同一历史记录；多个名称使用英文逗号分隔。名称缺失返回 null。
• pre_ztwme（number|null）：所查询交易日的上一交易日涨停委买额，按交易日历定位，单位元。已发布且 ready 的逐笔修复事实优先，保留修复后的金额门槛和 null；没有已发布修复事实的日期/股票沿用旧 KPL 来源。缺失或被门槛清空返回 null，不以旧值或零补齐。
• prev_ztwme（number|null）：所查询交易日的前两个交易日涨停委买额，按交易日历定位，单位元。已发布且 ready 的逐笔修复事实优先，保留修复后的金额门槛和 null；没有已发布修复事实的日期/股票沿用旧 KPL 来源。缺失或被门槛清空返回 null，不以旧值或零补齐。