Tailpick 选股

来源同步：/Users/mac/Projects/chatgpt-codex/doc/api_Screener.md

所属接口集：股票筛选

请求 URL

POST /v1/api/screener/tailpick

认证方式

Bearer Token（详见 认证与签名）

接口概述

基于 Tailpick 策略的选股接口。通过板块代码或股票代码列表指定选股范围，对股票进行多维度筛选和评分，返回得分最高的 topn 只股票。详细策略逻辑参见 策略参数查询与设置。

请求参数

Query 参数：

参数	类型	必填	默认值	说明
end	string	否	最近交易日	目标交易日期，格式 YYYYMMDD 或 YYYY-MM-DD
freq	string	否	D	K线频率，如 D（日线）
min_amount	float	否	1e8	最低成交额过滤阈值
turnover_min	float	否	2.0	最低换手率
turnover_max	float	否	20.0	最高换手率
price_min	float	否	3.0	最低价格
price_max	float	否	50.0	最高价格
vol_mult	float	否	1.5	量比最低倍数
near_high	float	否	0.005	接近新高阈值
topn	int	否	30	返回排名前 N 只
threads	int	否	8	并发线程数
minute_last30	float	否	1.15	最后30分钟量能比阈值
minute_baseline	float	否	1.05	分钟量能基准比阈值
intraday_strength_min	float	否	0.003	盘中强度最低值
intraday_vwap_diff_min	float	否	-0.002	盘中 VWAP 偏离度最低值
intraday_range_max	float	否	0.05	盘中振幅最高值
intraday_last_minutes	int	否	30	盘中尾部观察分钟数
intraday_lookback_days	int	否	30	盘中回溯天数

Body 参数（JSON）：

参数	类型	必填	默认值	说明
block_code	string	否	-	板块代码，逗号分隔多个。与 codes 互斥，二选一必填
codes	string/array	否	-	股票代码列表，逗号分隔字符串或数组。与 block_code 互斥

block_code 和 codes 互斥，必须且只能提供其中一个。

接口说明

• 当提供 block_code 时，通过 tdx_block_members 表展开为具体股票代码。
• 自动排除 stock_advice 表中 status=0 的股票（推荐排除）以及 ST / *ST 股票。
• 内部按 1000 只一批分块计算，结果按 score 降序合并。
• 计算结果缓存 300 秒。
• 响应中附带 debug_info 包含实际使用的交易日期及回退天数。
• 每条结果额外包含 name（股票名称）和 current_price（实时最新价）。

响应格式示例

{
  "code": 1,
  "message": "success",
  "data": [
    {
      "code": "600000.SH",
      "name": "浦发银行",
      "current_price": 10.25,
      "score": 85.6,
      "turnover_rate": 3.21,
      "pct_chg": 1.52,
      "amount": 256000000,
      "position20": 0.62,
      "minute_vol_ratio": 1.12,
      "minute_last30_vol_ratio": 1.28,
      "intraday_strength": 0.005,
      "intraday_vwap_diff": 0.001,
      "intraday_range": 0.03
    }
  ],
  "debug_info": {
    "resolved_trade_date": "20250818",
    "fallback_days": 0
  }
}

返回状态

状态码	说明
200	成功
400	参数错误（block_code 与 codes 互斥、universe 为空等）
401	未认证
403	无权限
405	请求方法不允许（非 POST）

---