Skip to content

API_DOCUMENTATION.md

Latest commit

 

History

History
277 lines (242 loc) · 7.33 KB

API_DOCUMENTATION.md

File metadata and controls

277 lines (242 loc) · 7.33 KB

Stock Analyzer API 接口文档

本文档汇总了后端服务提供的所有股票策略筛选接口。

1. 基础信息

2. 策略筛选接口

2.1 周线连续阳线策略

查询周线级别连续收阳线的千亿市值主板股票。该策略适合寻找走势稳健、处于上升趋势的大盘蓝筹股。

  • 接口路径: /consecutive_yang_lines
  • HTTP方法: GET
  • 请求参数:
    • min_consecutive (int, 可选): 最少连续阳线周数，默认 3。
  • 返回字段: ts_code, 名称, 市值(亿), 行业, consecutive_yang_weeks, latest_close, total_return_during_yang 等。
  • 返回示例:
{
  "count": 1,
  "data": [
    {
      "ts_code": "600519.SH",
      "stock_name": "贵州茅台",
      "market_cap": "20000+",
      "industry": "白酒",
      "consecutive_yang_weeks": 3,
      "latest_close": 1550.0,
      "total_return_during_yang": 4.5
    }
  ]
}

2.2 周线底部放量反转策略

查询前期连续下跌（至少 3 周）后，在最近一周出现放量收阳反转信号的主板股票。适合抄底潜伏。

  • 接口路径: /weekly_bottom_reversal
  • HTTP方法: GET
  • 请求参数:
    • min_mv (float, 可选): 最小总市值（万元），默认 1000000 (100亿)。
    • min_drop_weeks (int, 可选): 反转前最少连续下跌周数，默认 3。
    • vol_ratio (float, 可选): 成交量放大倍数阈值，默认 1.5。
  • 返回示例:
{
  "count": 1,
  "data": [
    {
      "ts_code": "600737.SH",
      "代码": "600737.SH",
      "名称": "中粮糖业",
      "市值(亿)": 366.8,
      "现价": 17.18,
      "本周涨幅%": 0.02,
      "放量倍数": 2.16,
      "连续下跌周数": 3,
      "最近周线日期": "2025-12-20"
    }
  ]
}

2.3 低 PE + 周线放量策略

筛选主板中市值较大、估值较低且本周出现成交量显著放大的股票。

  • 接口路径: /low_pe_volume_surge
  • HTTP方法: GET
  • 请求参数:
    • min_mv (float, 可选): 最小总市值（万元），默认 2000000 (200亿)。
    • max_pe (float, 可选): 最大市盈率 (TTM)，默认不限制。
    • min_ratio (float, 可选): 周线放量倍数阈值，默认 1.3。
  • 返回字段: ts_code, 名称, 市值(亿), PE(TTM), 现价, 周放量倍数, 是否刚启动。
  • 返回示例:
{
  "count": 1,
  "data": [
    {
      "ts_code": "600036.SH",
      "名称": "招商银行",
      "市值(亿)": 8500.5,
      "PE(TTM)": 5.8,
      "现价": 32.5,
      "周放量倍数": 1.45,
      "是否刚启动": true
    }
  ]
}

2.4 均线下大盘股策略

查询市值巨大（千亿级）且当前价格低于最近一年周线均价的股票。

  • 接口路径: /large_cap_below_1y_avg_price
  • HTTP方法: GET
  • 请求参数:
    • min_mv (float, 可选): 最小总市值（万元），默认 10000000 (1000亿)。
    • max_pe (float, 可选): 最大市盈率 (TTM)，默认 30.0。
  • 返回字段: ts_code, name, total_mv_10k, pe_ttm, current_close, avg_close_1y。
  • 返回示例:
{
  "count": 1,
  "data": [
    {
      "ts_code": "601398.SH",
      "name": "工商银行",
      "total_mv_10k": 18000000,
      "pe_ttm": 4.5,
      "current_close": 5.2,
      "avg_close_1y": 5.8
    }
  ]
}

2.5 ETF 周线放量策略

查询周线级别明显放量的 ETF。

  • 接口路径: /etf_weekly_volume_surge
  • HTTP方法: GET
  • 请求参数:
    • min_ratio (float, 可选): 最小放量倍数，默认 1.5。
    • lookback_weeks (int, 可选): 回看周数，默认 3。
    • min_last_week_amount_yi (float, 可选): 最近一周成交额阈值（亿元），默认 1.0。
  • 返回示例:
{
  "count": 1,
  "data": [
    {
      "ts_code": "510300.SH",
      "代码": "510300.SH",
      "名称": "沪深300ETF",
      "最近周线截止日": "2025-12-20",
      "最近一周成交量(手)": 1234567.0,
      "最近一周成交额(亿元)": 50.5,
      "过去3周最大周成交量(手)": 800000.0,
      "周放量倍数": 1.54
    }
  ]
}

2.6 智能投资组合策略 (Smart Portfolio)

聚合多个策略模型的精选结果，自动进行行业分散处理，提供 3-5 只股票的推荐组合。

  • 接口路径: /smart_portfolio
  • HTTP方法: GET
  • 请求参数:
    • limit (int, 可选): 组合内股票数量上限，默认 5。
  • 返回示例:
{
  "count": 3,
  "data": [
    {
      "ts_code": "600519.SH",
      "名称": "贵州茅台",
      "策略标签": "稳健趋势",
      "行业": "白酒",
      "核心指标": "周线3连阳",
      "权重分数": 93
    },
    ...
  ],
  "diversification": "覆盖了 3 个不同行业"
}

2.7 日线底部放巨量策略

查询日线级别放巨量、当天收盘上涨、处于 250 日均线下方、且处于近一年价格低位的主板股票。

  • 接口路径: /daily_bottom_volume_surge
  • HTTP方法: GET
  • 请求参数:
    • vol_ratio (float, 可选): 成交量放大倍数阈值，默认 3.0。
    • price_pos (float, 可选): 价格位置阈值 (0-1)，默认 0.2 (处于过去 250 天波动的低位 20%)。
  • 返回字段: ts_code, name, industry, close, pct_chg, vol_ratio, price_pos, dist_to_ma250 等。
  • 返回示例:
{
  "count": 1,
  "data": [
    {
      "ts_code": "600000.SH",
      "name": "浦发银行",
      "industry": "银行",
      "close": 7.5,
      "pct_chg": 1.2,
      "vol_ratio": 3.5,
      "price_pos": 0.15,
      "ma250": 8.2,
      "dist_to_ma250": -8.54,
      "trade_date": "2025-12-29"
    }
  ]
}

3. 数据查询接口

3.1 单股一年历史行情

获取指定股票最近 1 年的日线价格和成交量数据，常用于前端绘制 K 线图或趋势图。

  • 接口路径: /price_volume_1y
  • HTTP方法: GET
  • 请求参数:
    • ts_code (str, 必选): 股票代码，如 600519.SH。
  • 返回字段: trade_date, open, high, low, close, vol, amount。

3.2 市场活跃股票排行

获取当前交易日市场成交额或成交量最大的前 N 只股票。

  • 接口路径: /top_active_stocks
  • HTTP方法: GET
  • 请求参数:
    • limit (int, 可选): 返回数量，默认 20。
    • sort_by (str, 可选): 排序依据，amount (成交额，默认) 或 vol (成交量)。
  • 返回字段: ts_code, name, trade_date, 现价, 涨跌幅, 成交量(手), 成交额(亿元)。
  • 返回示例:
{
  "latest_trade_date": "2025-12-24",
  "count": 20,
  "data": [
    {
      "ts_code": "000001.SZ",
      "name": "平安银行",
      "trade_date": "2025-12-24",
      "现价": 15.5,
      "涨跌幅": 1.2,
      "成交量(手)": 1234567.0,
      "成交额(亿元)": 19.13
    },
    ...
  ]
}

4. 统一响应格式说明

所有接口均返回标准 JSON 格式，结构如下：

{
  "count": 10,
  "data": [
    { ... 数据对象1 ... },
    { ... 数据对象2 ... }
  ]
}

如果接口出错（如数据库连接失败），会返回相应的 error 字段及 500 状态码。