板块异动快照

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

所属接口集：板块行情

请求 URL

GET /v1/api/market/movements

认证方式

Bearer Token（详见 认证与签名）

接口概述

返回板块异动快照，并附带市场级换手分析（加权平均、分位数、市场状态、情绪指标）。数据来源为后台调度器实时同步的 boards_board_snapshot 表。

请求参数

参数	类型	必填	说明
type	string	否	板块类型：industry（默认）、concept
limit	int	否	返回的板块数量，默认 10，范围 1~MAX_TOP（默认 200）
sort	string	否	排序字段：pct（默认）、main_net、amount、turnover、event_ts、signal
order	string	否	排序方向：desc（默认）、asc
turnover_min	float	否	最小换手过滤（turnover > turnover_min）
date	string	否	按 updated_at 日期过滤，支持 YYYYMMDD 或 YYYY-MM-DD
code / board_code	string	否	逗号分隔的板块代码，精确匹配筛选
name / board_name	string	否	板块名称关键词，不区分大小写子串匹配
signals	string	否	信号过滤，逗号分隔：资金进攻、高位出货、中性、冷门板块
flow	string	否	资金方向过滤：out（主力流出）、in（主力流入）、flat（平衡）
page	int	否	分页页码（从 1 开始），传入 page 或 page_size 启用分页
page_size	int	否	每页条数，默认 50，最大 100

接口说明

• 数据源互补：type=industry 读 akshare（含 cache）快照；type=concept 读 push2 快照。后台 ingest 同样按此互补主源写入。接口不支持 source 查询参数。
• 顶层 ts 为数据更新时间（data_ts），items[].ts 为该板块快照的 updated_ts。
• 板块名称去重：对 Ⅱ/Ⅲ 等后缀视为同一板块，只保留代表行。
• 信号计算逻辑：
• 资金进攻：换手率 ≥ P80 且主力净流入 > 0
• 高位出货：换手率 ≥ P80 且主力净流入 < 0
• 冷门板块：换手率 ≤ P20
• 中性：其余情况
• 资金方向标签（flow_tag）：main_net > 0 → 流入，< 0 → 流出，= 0 或 None → 平衡。
• 市场状态（market_status）：加权平均换手率 > P80 → 过热，< P20 → 低迷，其余 → 正常。
• 加权平均换手率使用流通市值加权：Σ(turnover × float_mv) / Σ(float_mv)。
• 分页：先按排序结果截取 limit 条，再按 page/page_size 分页返回。
• 领涨股按市场分组（沪/深/北/创业板/科创板），每个市场最多 3 只，总计最多 15 只。

响应格式示例

{
  "ts": 1739679988,
  "source": "push2",
  "type": "concept",
  "market": {
    "data_updated_ts": 1739679988,
    "latest_event_ts": 1739679955,
    "sample_size": 86,
    "avg_turnover": 2.85,
    "p80": 4.5,
    "p50": 2.1,
    "p20": 1.2,
    "market_status": "正常",
    "low_confidence": false
  },
  "market_summary": {},
  "market_sentiment": {},
  "items": [
    {
      "board_code": "BK1035",
      "board_name": "港口航运",
      "pct": 0.0236,
      "amount": 123456789.0,
      "main_net": 2345678.0,
      "turnover": 2.38,
      "float_mv": 5.6e11,
      "total_mv": 7.8e11,
      "leaders": [
        {"code": "600017", "name": "南京港", "pct_chg": 0.0799}
      ],
      "leaders_by_market": {
        "sh": [],
        "sz": [{"code": "600017", "name": "南京港", "pct_chg": 0.0799}],
        "bj": [],
        "cyb": [],
        "star": []
      },
      "event_ts": 1739679955,
      "percentile_rank": 0.76,
      "signal": "资金进攻",
      "signal_rank": 3,
      "flow_tag": "流入",
      "ts": 1739679900
    }
  ],
  "total": 10,
  "total_pages": 1,
  "page": 1,
  "page_size": 10
}

返回状态

状态码	说明
200	成功
400	参数错误（如无效的 type/sort/signals/flow）
401	未认证
403	无权限

---