历史回溯

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

所属接口集：投资建议

请求 URL

GET /v1/api/history

认证方式

Bearer Token（详见 认证与签名）

接口概述

查询历史涨停池数据，支持分页、主力控盘过滤和多日回溯。

请求参数

参数名	类型	必填	说明
date	string	否	查询日期，格式 YYYYMMDD，默认当天。若指定日期无数据且未显式指定，自动回溯到最近有数据的交易日
freq	int	否	时间窗口频率，可选值：5/10/20/60/90/180，默认 90
page	int	否	页码，默认 1
page_size	int	否	每页条数，默认 50，最大 500
main_control_min	float	否	主力控盘最小值过滤，仅返回 main_control 大于该值的记录

接口说明

• 数据来源为 history_daily_item 表。
• 若指定日期无数据且未显式传 date，会自动回溯最多 60 个自然日查找最近有数据的交易日。
• 返回结果按板块和行业分类，包含概念题材、主题、实时行情和策略快照数据。
• 当 main_control_min 有值时，仅返回主力控盘超过阈值的记录。
• 响应中额外包含 aggregate 聚合分析数据（股票和概念热度排名）及 paging 分页信息。

响应格式示例

{
  "code": 1,
  "message": "success",
  "data": [
    {
      "date": "20240709",
      "sorted_by_board": [
        {
          "code": "000001",
          "name": "平安银行",
          "pool": {
            "time_weight": 0.8,
            "strength_weight": 0.5,
            "event_score": 0.9
          },
          "close": 12.9,
          "pct_chg": 3.21,
          "free_float_shares": 1000000,
          "概念题材": ["银行"],
          "主题": ["金融科技"],
          "main_control": 0.65,
          "pct_5d_recent": 2.1,
          "pct_10d_recent": 3.5,
          "pct_20d_recent": 5.2
        }
      ],
      "sorted_by_industry": []
    }
  ],
  "aggregate": {
    "window": {
      "end": "20240709",
      "freq": 90,
      "tau_days": 7
    },
    "stocks": [
      {
        "code": "000001",
        "name": "平安银行",
        "score": 0.85,
        "recent_share_7d": 0.6,
        "events_30": 5,
        "last_seen_date": "20240709",
        "last_seen_days_ago": 0
      }
    ],
    "concepts_top": [
      {
        "concept": "银行",
        "score": 0.72,
        "recent_share_7d": 0.5,
        "stock_count": 3
      }
    ]
  },
  "paging": {
    "page": 1,
    "page_size": 50,
    "total": 100,
    "total_pages": 2,
    "freq": 90
  }
}

返回状态

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