因子排行榜

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

所属接口集：排行榜

请求 URL

GET /v1/api/factor/leaderboard

认证方式

Bearer Token（详见 认证与签名）

接口概述

因子排行榜，按综合评分排列股票。支持三种数据源：策略竞价（strategy）、今日监控（monitor）、历史实盘（history）。包含趋势强度和板块动量等因子。

请求参数

参数	类型	必填	说明
day	string	否	查询日期，格式 YYYYMMDD，默认今天
source	string	否	数据源：strategy（策略竞价）、monitor（今日监控）、history（历史实盘），默认 strategy
limit	int	否	返回数量，默认 50（向后兼容，优先使用 page/page_size）
page	int	否	页码，默认 1
page_size	int	否	每页数量，默认 50，最大 500
code	string	否	代码过滤，逗号分隔
name	string	否	名称过滤，逗号分隔
q	string	否	通用搜索（自动判断代码或名称）
exclude_prefixes	string	否	排除代码前缀，逗号分隔，如 688,300

接口说明

• strategy 源：从 Redis 策略竞价快照读取，包含评分、竞价强度、趋势强度、板块动量
• monitor 源：从 Redis 今日监控快照读取，score 取当日涨幅，趋势强度使用专用计算
• history 源：从 MySQL 历史数据读取，趋势强度从 TrendMetricsDaily 静态表读取
• 结果按 score 降序排列
• 板块动量从 vw_hot_block_scores 视图计算，窗口 30 天
• 支持 q 参数智能判断：纯数字按代码过滤，含中文按名称过滤

响应格式示例

{
  "code": 1,
  "message": "success",
  "data": {
    "day": "20260113",
    "source": "strategy",
    "page": 1,
    "page_size": 50,
    "total": 120,
    "total_pages": 3,
    "items": [
      {
        "code": "600519.SH",
        "name": "贵州茅台",
        "score": 95.0,
        "curr_price": 1810.0,
        "gap_open": 0.003,
        "limit_gap": 0.0833,
        "auction_strength": 0.85,
        "trend_strength": 0.78,
        "sector_momentum": 12.5,
        "pct_chg": 0.56,
        "reason": "竞价强势",
        "sector_block_code": "BK0001",
        "sector_block_name": "白酒"
      }
    ]
  }
}

返回状态

状态码	说明
200	成功
401	未认证
403	无权限

---