推荐历史

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

所属接口集：投资建议

请求 URL

GET /v1/api/advice-stock-history

认证方式

Bearer Token（详见 认证与签名）

接口概述

查询推荐历史记录，支持分页、策略筛选、状态筛选和排序。

请求参数

参数名	类型	必填	说明
date	string	否	查询日期，格式 YYYYMMDD。提供时仅查询当天记录，不提供则查询全部
page	int	否	页码，与 page_size 同时提供时启用分页模式
page_size	int	否	每页条数，最大 200，与 page 同时提供时启用分页模式
limit	int	否	非分页模式下返回条数，默认 100，最大 2000
strategy	string	否	按策略名称筛选
exclude_strategy	string	否	排除的策略名称，多个用逗号分隔
status	string	否	按状态筛选，多个用逗号分隔，如 0,1
sort	string	否	排序字段，支持 pct_chg，其他值按日期降序
order	string	否	排序方向，asc 或 desc，默认 desc

接口说明

• 分页模式：同时提供 page 和 page_size 时启用，优先于 limit。
• 非分页模式：未提供分页参数时，按 limit 控制返回条数。
• 返回结果中会注入实时行情数据（close、pre_close、pct_chg）。
• verified_at 字段会格式化为 YYYYMMDD 格式。
• 返回记录中包含 ret_chg 字段，为原始 pct_chg 的浮点数转换。

响应格式示例

{
  "code": 1,
  "message": "success",
  "data": {
    "page": 1,
    "page_size": 100,
    "total": 50,
    "items": [
      {
        "id": 1,
        "date": "20240709",
        "code": "000001",
        "name": "平安银行",
        "recommended_price": 12.5,
        "pct_chg": 3.21,
        "verify_note": null,
        "status": 0,
        "reason": "技术突破",
        "industry": "银行",
        "strategy": "涨停板",
        "verified_at": null,
        "ret_chg": 3.21,
        "close": 12.9,
        "pre_close": 12.5
      }
    ]
  }
}

返回状态

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

---