专题数据 · KlineShare

涨停专题 {#limit-up}

涨停专题（scope：limit_up）覆盖涨停数据（实时）、连板天梯（实时）、板块排名与个股/板块异动，盘中实时更新。

开通与试用 {#limit-up-tiers}

打板、异动、快讯等专题接口按每个 endpoint 单独配置正式开通或试用（周期天数 + 窗口内次数），由角色权限决定，不固定绑定某一套餐档位。

查询当前 Key：GET /v1/me 返回 endpoint_access_status（逐接口 access_mode、period_days、max_uses、remaining）及 scopes / scope_rows。
试用计数：各 endpoint 独立计数（含沙盒与 API 调用）；SSE 订阅按新建连接计次。额度按配置周期重置（默认每自然日）。
超出试用额度返回 429；未开通返回 403。
公开目录见 GET /public/v1/catalog 的 endpoint_catalog 与 scope_rows（矩阵为展示参考，以账号实际配置为准）。

接口一览 {#limit-up-routes}

GET /v1/limit-up                      # 涨停数据（实时）
GET /v1/limit-up/break                # 炸板数据（实时）
GET /v1/limit-up/limit-down           # 跌停数据（实时）
GET /v1/limit-up/yesterday            # 昨日涨停（实时）— 昨日封板标的今日行情
GET /v1/limit-up/ladder               # 连板天梯（实时）— 按连板高度分组
GET /v1/limit-up/plates/trending      # 行业板块排名（实时）
GET /v1/limit-up/plates/industry      # 行业板块（实时）
GET /v1/limit-up/plates/concept       # 概念板块排名（实时）
GET /v1/limit-up/plates/style         # 风格板块排名（实时）
GET /v1/abnormal-events               # 异动历史（单次拉取）
GET /v1/abnormal-events/stream        # 异动实时订阅（SSE 长连接）

异动推送 {#abnormal-events}

盘中个股与板块异动：封板、炸板、拉升、跳水等。

历史拉取 GET /v1/abnormal-events：

参数	说明
`count`	条数，默认 30，最大 100
`types`	逗号分隔的异动类型，不传为全部 14 类（见下表）
`kind`	`all` / `stock` / `plate`，默认 `all`
`timestamp`	翻页游标，取上一页最后一条 `occurred_at`

异动类型（types 参数与响应 type 字段）：

type	说明	类别
`limit_up_seal`	封涨停板	个股
`limit_down_seal`	封跌停板	个股
`limit_up_open`	打开涨停板	个股
`limit_down_open`	打开跌停板	个股
`limit_up_near`	逼近涨停	个股
`limit_down_near`	逼近跌停	个股
`limit_up_about_open`	即将打开涨停	个股
`limit_down_about_open`	即将打开跌停	个股
`stock_surge`	大幅拉升	个股
`stock_plunge`	快速跳水	个股
`ipo_open`	新股开板	个股
`ipo_reseal`	新股开板回封	个股
`plate_surge`	板块拉升	板块
`plate_plunge`	板块跳水	板块

实时订阅 GET /v1/abnormal-events/stream：

订阅模式：客户端发起 GET 并保持长连接（SSE），服务端在有新异动时推送；不是轮询历史接口。
同一 API Key 并发订阅数见 GET /v1/me 的 max_abnormal_events_subscriptions（由角色配置）；超出上限时顶掉最早建立的连接，被顶掉端收到 {"type":"evicted",...} 后断开。
响应类型 text/event-stream；首条为 {"type":"ready","subscription":{...}}，之后每条异动为 {"type":"event","data":{...}}（data 字段结构与历史上 data[] 单条一致）。
参数 types、kind 与历史接口相同，用于订阅过滤；约每 15 秒发送心跳注释行。
断开连接即取消订阅；每次新建连接计 1 次调用（试用额度按连接次数，非按推送条数）。
客户端示例：curl -N -H "X-API-Key: tg_xxx" "https://api.example/v1/abnormal-events/stream?kind=stock"
浏览器端需用 fetch 流式读取（原生 EventSource 不支持自定义 X-API-Key Header）。
鉴权：X-API-Key + scope abnormal_events。
sentiment：1 偏多、-1 偏空、0 中性；minute_change_percent 为分时涨跌幅（小数）。
响应 meta.types 为本次请求的异动类型；meta.type_catalog 为全部类型目录。

字段说明：

字段	类型	说明
`id`	int	异动记录 ID
`kind`	string	`stock` 个股 / `plate` 板块
`type`	string	异动类型（见上表）
`type_label`	string	异动类型中文名
`occurred_at`	int	发生时刻 Unix 秒
`occurred_time`	string	发生时刻 `HH:MM:SS`
`sentiment`	int	多空倾向：`1` 偏多、`-1` 偏空、`0` 中性
`symbol`	string	股票代码（个股异动）
`name`	string	简称（个股）或板块名（板块异动）
`price`	number	现价（个股异动）
`change_percent`	number	涨跌幅（小数）
`minute_change_percent`	number	分时涨跌幅（小数，个股异动）
`plates`	array	关联板块：`name`、`change_percent`
`stocks`	array	关联个股（板块异动）：`symbol`、`name`、`change_percent` 等

市场快讯 {#market-flash}

市场快讯（scope：market_flash）为 SSE 实时订阅，盘中推送发布、更新与撤回事件；暂无历史拉取接口。

开通与试用 {#market-flash-tiers}

市场快讯（market_flash）按 endpoint 配置正式开通或试用，见 GET /v1/me 的 endpoint_access_status。

GET /v1/market-flash/stream        # 市场快讯实时订阅（SSE 长连接）

实时订阅 GET /v1/market-flash/stream：

订阅模式：客户端发起 GET 并保持长连接（SSE），服务端在有新快讯时推送。
同一 API Key 并发订阅数见 GET /v1/me 的 max_market_flash_subscriptions（由角色配置）；超出上限时顶掉最早建立的连接，被顶掉端收到 {"type":"evicted",...} 后断开。
响应类型 text/event-stream；首条为 {"type":"ready","subscription":{...}}，之后每条为 {"type":"event","data":{...}}。
参数 actions：逗号分隔，可选 publish（发布）、update（更新）、withdraw（撤回）；不传为全部。
参数 include_withdrawn：传 1/true 时包含已撤回条目；默认过滤。
约每 15 秒发送心跳注释行；断开连接即取消订阅；每次新建连接计 1 次调用。
鉴权：X-API-Key + scope market_flash。

字段说明（data 单条）：

字段	类型	说明
`action`	string	`publish` / `update` / `withdraw`
`action_label`	string	动作中文名
`title`	string	标题
`summary`	string	摘要（可选）
`content`	string	正文（可选）
`subtitle`	string	副标题（可选）
`occurred_at`	int	发生时刻 Unix 秒
`occurred_time`	string	发生时刻 `HH:MM:SS`
`updated_at`	int	更新时间 Unix 秒（可选）
`sentiment`	int	多空倾向：`1` 偏多、`-1` 偏空、`0` 中性
`is_withdrawn`	bool	是否已撤回
`has_summary`	bool	是否有摘要
`image`	string	配图 URL（可选）
`plates`	array	关联板块：`name`、`change_percent`
`stocks`	array	关联个股：`symbol`、`name`、`change_percent`

涨停专题（续） {#limit-up-continued}

通用约定：

鉴权：X-API-Key + scope limit_up。
涨停数据（实时）与连板天梯（实时）无请求参数，返回当日盘中快照。
打板五接口（/v1/limit-up、/break、/limit-down、/yesterday、/ladder）正式开通时共用 15 次/分钟 限流；板块排名仍按 limit_up 240 次/分钟。
板块排名支持 limit（默认 50，最大 200）；行业/概念/风格另支持 field（排序字段，默认 core_avg_pcp 核心均涨幅）。
响应统一为 { success, data[], meta }；meta.as_of 为响应时间 YYYYMMDDHHmmss；涨停数据（实时） meta.count 为全量条数（data 返回全部，非分页）。
change_percent、turnover_rate 等为小数：0.099962 ≈ +9.996%，0.10023 ≈ +10.023%（已四舍五入到 6 位小数）。
symbol 统一代码格式：603778.SS（沪）、002962.SZ（深）。
封板/炸板时刻：first_sealed_at 等为 Unix 秒（UTC+8 交易时段），*_time 为 HH:MM:SS 便于展示。

涨停数据（实时） {#limit-up-pool}

GET /v1/limit-up — 当日盘中涨停数据（实时）。默认排序：连板天数降序 → 首封时间升序（越早封板越靠前）。

字段	类型	说明
symbol	string	股票代码，如 `002674.SZ`
name	string	简称
price	number	现价
change_percent	number	涨跌幅（小数）
turnover_rate	number	换手率（小数）
consecutive_days	int	连板天数（含当日）
first_sealed_at	int	首次封涨停 Unix 秒
first_sealed_time	string	首次封涨停 `HH:MM:SS`
last_sealed_at	int	末次封涨停 Unix 秒
last_sealed_time	string	末次封涨停 `HH:MM:SS`
open_count	int	开板次数（0=一字板）

响应示例（2026-06-27 盘中，data 截取前 3 条，meta.count=73 为全量）：

{
  "success": true,
  "data": [
    {
      "symbol": "002674.SZ",
      "name": "兴业科技",
      "price": 28.83,
      "change_percent": 0.099962,
      "turnover_rate": 0.02574,
      "consecutive_days": 6,
      "first_sealed_at": 1782437100,
      "first_sealed_time": "09:25:00",
      "last_sealed_at": 1782437100,
      "last_sealed_time": "09:25:00",
      "open_count": 0
    },
    {
      "symbol": "603595.SS",
      "name": "ST东尼",
      "price": 36.98,
      "change_percent": 0.049972,
      "turnover_rate": 0.014485,
      "consecutive_days": 6,
      "first_sealed_at": 1782437101,
      "first_sealed_time": "09:25:01",
      "last_sealed_at": 1782438076,
      "last_sealed_time": "09:41:16",
      "open_count": 2
    },
    {
      "symbol": "605366.SS",
      "name": "宏柏新材",
      "price": 14.38,
      "change_percent": 0.10023,
      "turnover_rate": 0.195887,
      "consecutive_days": 4,
      "first_sealed_at": 1782437483,
      "first_sealed_time": "09:31:23",
      "last_sealed_at": 1782455925,
      "last_sealed_time": "14:38:45",
      "open_count": 47
    }
  ],
  "meta": {
    "pool": "limit_up",
    "label": "涨停数据（实时）",
    "route": "/v1/limit-up",
    "count": 73,
    "as_of": "20260627230705"
  }
}

连板天梯（实时） {#limit-up-ladder}

GET /v1/limit-up/ladder — 根据当日涨停数据（实时），按 consecutive_days（连板高度）分组为梯队层级。同一高度内按首封时间升序排列。

字段	类型	说明
data.height	int	连板高度（≥1）
data.label	string	中文标签，如 `6连板`
data.count	int	该高度涨停家数
data.stocks	array	该层个股列表
data.stocks.symbol / name		代码、简称
data.stocks.price / change_percent / turnover_rate		现价、涨跌幅、换手率
data.stocks.first_sealed_at / first_sealed_time		首封时刻
data.stocks.last_sealed_at / last_sealed_time		末封时刻
data.stocks.open_count	int	开板次数

meta.max_height 为当前市场最高连板数；meta.height_count 为有天梯的层数（仅含当日有票的高度）；meta.total_stocks 与涨停数据（实时）总数一致。

响应示例（2026-06-27 盘中，stocks 每层截取前 2 条；实际返回该层全部个股）：

{
  "success": true,
  "data": [
    {
      "height": 6,
      "label": "6连板",
      "count": 2,
      "stocks": [
        {
          "symbol": "002674.SZ",
          "name": "兴业科技",
          "price": 28.83,
          "change_percent": 0.099962,
          "turnover_rate": 0.02574,
          "first_sealed_at": 1782437100,
          "first_sealed_time": "09:25:00",
          "last_sealed_at": 1782437100,
          "last_sealed_time": "09:25:00",
          "open_count": 0
        },
        {
          "symbol": "603595.SS",
          "name": "ST东尼",
          "price": 36.98,
          "change_percent": 0.049972,
          "turnover_rate": 0.014485,
          "first_sealed_at": 1782437101,
          "first_sealed_time": "09:25:01",
          "last_sealed_at": 1782438076,
          "last_sealed_time": "09:41:16",
          "open_count": 2
        }
      ]
    },
    {
      "height": 4,
      "label": "4连板",
      "count": 2,
      "stocks": [
        {
          "symbol": "605366.SS",
          "name": "宏柏新材",
          "price": 14.38,
          "change_percent": 0.10023,
          "turnover_rate": 0.195887,
          "first_sealed_at": 1782437483,
          "first_sealed_time": "09:31:23",
          "last_sealed_at": 1782455925,
          "last_sealed_time": "14:38:45",
          "open_count": 47
        },
        {
          "symbol": "002822.SZ",
          "name": "ST中装",
          "price": 2.9,
          "change_percent": 0.050725,
          "turnover_rate": 0.033443,
          "first_sealed_at": 1782438735,
          "first_sealed_time": "09:52:15",
          "last_sealed_at": 1782439905,
          "last_sealed_time": "10:11:45",
          "open_count": 1
        }
      ]
    },
    {
      "height": 3,
      "label": "3连板",
      "count": 1,
      "stocks": [
        {
          "symbol": "000823.SZ",
          "name": "超声电子",
          "price": 28.46,
          "change_percent": 0.100116,
          "turnover_rate": 0.178575,
          "first_sealed_at": 1782437100,
          "first_sealed_time": "09:25:00",
          "last_sealed_at": 1782443469,
          "last_sealed_time": "11:11:09",
          "open_count": 21
        }
      ]
    },
    {
      "height": 2,
      "label": "2连板",
      "count": 7,
      "stocks": [
        {
          "symbol": "600228.SS",
          "name": "返利科技",
          "price": 10.79,
          "change_percent": 0.099898,
          "turnover_rate": 0.001429,
          "first_sealed_at": 1782437101,
          "first_sealed_time": "09:25:01",
          "last_sealed_at": 1782437101,
          "last_sealed_time": "09:25:01",
          "open_count": 0
        },
        {
          "symbol": "603956.SS",
          "name": "威派格",
          "price": 5.83,
          "change_percent": 0.1,
          "turnover_rate": 0.014188,
          "first_sealed_at": 1782437101,
          "first_sealed_time": "09:25:01",
          "last_sealed_at": 1782437101,
          "last_sealed_time": "09:25:01",
          "open_count": 0
        }
      ]
    },
    {
      "height": 1,
      "label": "1连板",
      "count": 61,
      "stocks": [
        {
          "symbol": "600180.SS",
          "name": "*ST瑞茂",
          "price": 1.13,
          "change_percent": 0.046296,
          "turnover_rate": 0.004784,
          "first_sealed_at": 1782437101,
          "first_sealed_time": "09:25:01",
          "last_sealed_at": 1782437101,
          "last_sealed_time": "09:25:01",
          "open_count": 0
        },
        {
          "symbol": "002568.SZ",
          "name": "百润股份",
          "price": 15.73,
          "change_percent": 0.1,
          "turnover_rate": 0.016421,
          "first_sealed_at": 1782437400,
          "first_sealed_time": "09:30:00",
          "last_sealed_at": 1782437400,
          "last_sealed_time": "09:30:00",
          "open_count": 0
        }
      ]
    }
  ],
  "meta": {
    "source": "limit_up",
    "label": "连板天梯（实时）",
    "route": "/v1/limit-up/ladder",
    "max_height": 6,
    "height_count": 5,
    "total_stocks": 73,
    "as_of": "20260627231145"
  }
}

上例当日最高 6 连板（兴业科技、ST东尼），共 5 个高度层、73 只涨停股。若某高度当日无涨停股，该层不会出现在 data 中（如无 5 连板层）。

炸板数据（实时） {#limit-up-break}

GET /v1/limit-up/break — 曾触涨停但未封住的标的。默认排序：炸板次数降序 → 首次炸板时间升序。

字段	类型	说明
symbol / name / price / change_percent / turnover_rate		同涨停数据（实时）
consecutive_days	int	连板天数（触板语境，非封板）
first_limit_up_at	int	首次触涨停 Unix 秒
first_limit_up_time	string	首次触涨停 `HH:MM:SS`
first_break_at	int	首次炸板 Unix 秒
first_break_time	string	首次炸板 `HH:MM:SS`
break_count	int	炸板次数

响应示例（2026-06-27 盘中，截取前 3 条）：

{
  "success": true,
  "data": [
    {
      "symbol": "605366.SS",
      "name": "宏柏新材",
      "price": 14.38,
      "change_percent": 0.10023,
      "turnover_rate": 0.195887,
      "consecutive_days": 4,
      "first_limit_up_at": 1782437483,
      "first_limit_up_time": "09:31:23",
      "first_break_at": 1782437498,
      "first_break_time": "09:31:38",
      "break_count": 47
    },
    {
      "symbol": "002962.SZ",
      "name": "五方光电",
      "price": 19.34,
      "change_percent": 0.100114,
      "turnover_rate": 0.257957,
      "consecutive_days": 1,
      "first_limit_up_at": 1782440109,
      "first_limit_up_time": "10:15:09",
      "first_break_at": 1782440223,
      "first_break_time": "10:17:03",
      "break_count": 41
    },
    {
      "symbol": "603650.SS",
      "name": "彤程新材",
      "price": 85.83,
      "change_percent": 0.099962,
      "turnover_rate": 0.058396,
      "consecutive_days": 1,
      "first_limit_up_at": 1782438000,
      "first_limit_up_time": "09:40:00",
      "first_break_at": 1782438018,
      "first_break_time": "09:40:18",
      "break_count": 33
    }
  ],
  "meta": {
    "pool": "break_limit_up",
    "label": "炸板数据（实时）",
    "route": "/v1/limit-up/break",
    "count": 73,
    "as_of": "20260627230705"
  }
}

同一只股票可能同时出现在涨停数据（实时）与炸板数据（实时）中（如宏柏新材：当日仍封住涨停，但盘中多次开板，炸板数据按触板记录统计）。

跌停数据（实时） {#limit-up-limit-down}

GET /v1/limit-up/limit-down — 当日盘中跌停数据（实时）。默认排序：连续跌停天数降序 → 首次封跌停时间升序。

字段	类型	说明
symbol / name / price / change_percent / turnover_rate		同涨停数据（实时）
consecutive_down_days	int	连续跌停天数
first_sealed_at / first_sealed_time		首次封跌停
last_sealed_at / last_sealed_time		末次封跌停
break_count	int	打开跌停次数

响应示例（2026-06-27 盘中，截取前 3 条）：

{
  "success": true,
  "data": [
    {
      "symbol": "603272.SS",
      "name": "*ST联翔",
      "price": 24.03,
      "change_percent": -0.049822,
      "turnover_rate": 0.046138,
      "consecutive_down_days": 7,
      "first_sealed_at": 1782437101,
      "first_sealed_time": "09:25:01",
      "last_sealed_at": 1782442601,
      "last_sealed_time": "10:56:41",
      "break_count": 12
    },
    {
      "symbol": "002514.SZ",
      "name": "*ST宝馨",
      "price": 2.25,
      "change_percent": -0.050633,
      "turnover_rate": 0.084896,
      "consecutive_down_days": 5,
      "first_sealed_at": 1782437100,
      "first_sealed_time": "09:25:00",
      "last_sealed_at": 1782452805,
      "last_sealed_time": "13:46:45",
      "break_count": 7
    },
    {
      "symbol": "002789.SZ",
      "name": "*ST建艺",
      "price": 11.5,
      "change_percent": -0.050372,
      "turnover_rate": 0.031766,
      "consecutive_down_days": 5,
      "first_sealed_at": 1782437577,
      "first_sealed_time": "09:32:57",
      "last_sealed_at": 1782454281,
      "last_sealed_time": "14:11:21",
      "break_count": 8
    }
  ],
  "meta": {
    "pool": "limit_down",
    "label": "跌停数据（实时）",
    "route": "/v1/limit-up/limit-down",
    "count": 44,
    "as_of": "20260627230705"
  }
}

昨日涨停（实时） {#limit-up-yesterday}

GET /v1/limit-up/yesterday — 昨日涨停标的的今日行情与昨日封板信息。默认排序：昨连板降序 → 今日涨幅降序。

字段	类型	说明
symbol / name / price / change_percent / turnover_rate		今日行情
yesterday_consecutive_days	int	昨日连板天数
yesterday_first_sealed_at / yesterday_first_sealed_time		昨日首封
yesterday_last_sealed_at / yesterday_last_sealed_time		昨日末封
yesterday_open_count	int	昨日开板次数

响应示例（2026-06-27，截取前 3 条）：

{
  "success": true,
  "data": [
    {
      "symbol": "002674.SZ",
      "name": "兴业科技",
      "price": 28.83,
      "change_percent": 0.099962,
      "turnover_rate": 0.02574,
      "yesterday_consecutive_days": 5,
      "yesterday_first_sealed_at": 1782350700,
      "yesterday_first_sealed_time": "09:25:00",
      "yesterday_last_sealed_at": 1782350700,
      "yesterday_last_sealed_time": "09:25:00",
      "yesterday_open_count": 0
    },
    {
      "symbol": "603595.SS",
      "name": "ST东尼",
      "price": 36.98,
      "change_percent": 0.049972,
      "turnover_rate": 0.014485,
      "yesterday_consecutive_days": 5,
      "yesterday_first_sealed_at": 1782351006,
      "yesterday_first_sealed_time": "09:30:06",
      "yesterday_last_sealed_at": 1782351006,
      "yesterday_last_sealed_time": "09:30:06",
      "yesterday_open_count": 0
    },
    {
      "symbol": "605366.SS",
      "name": "宏柏新材",
      "price": 14.38,
      "change_percent": 0.10023,
      "turnover_rate": 0.195887,
      "yesterday_consecutive_days": 3,
      "yesterday_first_sealed_at": 1782350701,
      "yesterday_first_sealed_time": "09:25:01",
      "yesterday_last_sealed_at": 1782350701,
      "yesterday_last_sealed_time": "09:25:01",
      "yesterday_open_count": 0
    }
  ],
  "meta": {
    "pool": "yesterday_limit_up",
    "label": "昨日涨停（实时）",
    "route": "/v1/limit-up/yesterday",
    "count": 91,
    "as_of": "20260627230706"
  }
}

GET /v1/limit-up/plates/trending — **行业板块排名（实时）**推荐列表，含说明文案与代表股。

参数	必填	说明
limit	否	返回条数，默认 50，最大 200

字段	类型	说明
id	int	板块 ID
name	string	板块名称
description	string	风口说明（与 `reason` 通常一致）
change_percent	number	核心均涨幅
rise_count / fall_count / limit_up_count	int	涨/跌/涨停家数
fund_flow	number	板块资金流向（元，可正可负）
reason	string	热点原因（若有）
stocks	array	代表股 `{ symbol, name }`

响应示例（?limit=3，2026-06-27）：

{
  "success": true,
  "data": [
    {
      "id": 92084622,
      "name": "玻璃基板封装",
      "change_percent": 0.012489,
      "rise_count": 24,
      "fall_count": 20,
      "limit_up_count": 5,
      "fund_flow": 1155415232.15,
      "reason": "康宁发布光学互连组件“玻璃桥”",
      "description": "康宁发布光学互连组件“玻璃桥”",
      "stocks": [
        { "symbol": "002962.SZ", "name": "五方光电" },
        { "symbol": "002106.SZ", "name": "莱宝高科" }
      ]
    },
    {
      "id": 6374814,
      "name": "大硅片",
      "change_percent": 0.047813,
      "rise_count": 15,
      "fall_count": 4,
      "limit_up_count": 2,
      "fund_flow": 2447353099.65,
      "reason": "台媒报道称行业释放出新一轮涨价信号",
      "description": "台媒报道称行业释放出新一轮涨价信号",
      "stocks": [
        { "symbol": "002129.SZ", "name": "TCL中环" },
        { "symbol": "605399.SS", "name": "晨光新材" }
      ]
    },
    {
      "id": 52153249,
      "name": "光刻机（胶）",
      "change_percent": 0.006207,
      "rise_count": 34,
      "fall_count": 40,
      "limit_up_count": 3,
      "fund_flow": -5616568797.29,
      "reason": "SK海力士计划募资近300亿美元，用于晶圆厂建设和EUV光刻机采购",
      "description": "SK海力士计划募资近300亿美元，用于晶圆厂建设和EUV光刻机采购",
      "stocks": [
        { "symbol": "603650.SS", "name": "彤程新材" },
        { "symbol": "603928.SS", "name": "兴业股份" }
      ]
    }
  ],
  "meta": {
    "kind": "trending",
    "label": "行业板块排名（实时）",
    "route": "/v1/limit-up/plates/trending",
    "limit": 3,
    "count": 3,
    "updated_at": 1782489000,
    "as_of": "20260627230706"
  }
}

行业板块（实时） {#limit-up-plates-industry}

GET /v1/limit-up/plates/industry — 行业板块按核心均涨幅排名。

参数	必填	说明
limit	否	默认 50，最大 200
field	否	排序字段，默认 `core_avg_pcp`

字段	类型	说明
id / name		板块 ID、名称
change_percent	number	核心均涨幅
rise_count / fall_count / limit_up_count	int	涨/跌/涨停家数
fund_flow	number	资金流向
reason	string	热点原因（若有）

响应示例（?limit=3）：

{
  "success": true,
  "data": [
    {
      "id": 22114510,
      "name": "玻纤",
      "change_percent": 0.03798,
      "rise_count": 8,
      "fall_count": 4,
      "limit_up_count": 1,
      "fund_flow": 531236928.93
    },
    {
      "id": 19771457,
      "name": "有机硅",
      "change_percent": 0.015502,
      "rise_count": 15,
      "fall_count": 16,
      "limit_up_count": 3,
      "fund_flow": -1320593432.19
    },
    {
      "id": 18533889,
      "name": "橡胶",
      "change_percent": 0.014571,
      "rise_count": 3,
      "fall_count": 4,
      "limit_up_count": 1,
      "fund_flow": -179699544.85
    }
  ],
  "meta": {
    "kind": "industry",
    "rank_type": 2,
    "label": "行业板块（实时）",
    "route": "/v1/limit-up/plates/industry",
    "field": "core_avg_pcp",
    "limit": 3,
    "count": 3,
    "as_of": "20260627230706"
  }
}

概念板块排名（实时） {#limit-up-plates-concept}

GET /v1/limit-up/plates/concept — 概念板块按核心均涨幅排名。参数与字段同行业板块。

响应示例（?limit=3）：

{
  "success": true,
  "data": [
    {
      "id": 6374814,
      "name": "大硅片",
      "change_percent": 0.047813,
      "rise_count": 15,
      "fall_count": 4,
      "limit_up_count": 2,
      "fund_flow": 2447353099.65,
      "reason": "台媒报道称行业释放出新一轮涨价信号"
    },
    {
      "id": 65767826,
      "name": "中芯国际概念股",
      "change_percent": 0.023123,
      "rise_count": 32,
      "fall_count": 20,
      "limit_up_count": 3,
      "fund_flow": -4685472299.99
    },
    {
      "id": 67510926,
      "name": "电子布",
      "change_percent": 0.017528,
      "rise_count": 7,
      "fall_count": 5,
      "limit_up_count": 0,
      "fund_flow": 643881263.89
    }
  ],
  "meta": {
    "kind": "concept",
    "rank_type": 1,
    "label": "概念板块（实时）",
    "route": "/v1/limit-up/plates/concept",
    "field": "core_avg_pcp",
    "limit": 3,
    "count": 3,
    "as_of": "20260627230706"
  }
}

风格板块排名（实时） {#limit-up-plates-style}

GET /v1/limit-up/plates/style — 风格板块按核心均涨幅排名。参数与字段同行业板块。

响应示例（?limit=3）：

{
  "success": true,
  "data": [
    {
      "id": 13492121,
      "name": "筹码集中",
      "change_percent": 0.002912,
      "rise_count": 8,
      "fall_count": 12,
      "limit_up_count": 3,
      "fund_flow": -151005399.3
    },
    {
      "id": 24898553,
      "name": "ST股",
      "change_percent": -0.004751,
      "rise_count": 74,
      "fall_count": 115,
      "limit_up_count": 13,
      "fund_flow": -990631157.62
    },
    {
      "id": 93250001,
      "name": "回购增持再贷款",
      "change_percent": -0.005521,
      "rise_count": 8,
      "fall_count": 15,
      "limit_up_count": 0,
      "fund_flow": 529549506.91
    }
  ],
  "meta": {
    "kind": "style",
    "rank_type": 3,
    "label": "风格板块（实时）",
    "route": "/v1/limit-up/plates/style",
    "field": "core_avg_pcp",
    "limit": 3,
    "count": 3,
    "as_of": "20260627230706"
  }
}

龙虎榜 {#lhb}

GET /v1/lhb/daily?date=2025-06-20&with_details=1
GET /v1/lhb/stock?symbol=600519&bdate=2025-06-01&edate=2025-06-20&with_details=1
GET /v1/lhb/dates?bdate=2020-01-01&edate=2025-06-20
GET /v1/lhb/stats?kind=stock&lastdays=5&page=1
GET /v1/lhb/stats?kind=broker&bdate=2025-06-01&edate=2025-06-20&page=1

需 lhb 权限（开通状态见 GET /v1/me）。也可使用 GET /v1/lhb（参数与 daily / stock 相同）。

日榜 `/v1/lhb/daily` {#lhb-daily}

参数	说明
date / tradedate	交易日 YYYY-MM-DD，留空为最近有数据的一日
with_details	`1` 含买卖前五席位
with_hot_money / tag_seats	默认 `1`，席位附加知名游资名称

无数据时返回 404。

单票 `/v1/lhb/stock` {#lhb-stock}

参数	说明
symbol	股票代码
bdate + edate	区间起止日（须同时提供）
with_details / with_hot_money / tag_seats	同日榜

日期 `/v1/lhb/dates` {#lhb-dates}

参数	说明
bdate / start	区间起始日 YYYY-MM-DD（可选）
edate / end	区间结束日 YYYY-MM-DD（可选）

返回 data.dates（有数据的交易日列表）、first / last、count；可选 with_details_count、updated_at。

统计 `/v1/lhb/stats` {#lhb-stats}

参数	说明
kind	`stock` 个股、`broker` 营业部、`inst` 机构增仓、`inst_detail` 机构明细
lastdays	默认 5，统计最近 N 个交易日（与 bdate/edate 二选一）
bdate + edate	指定区间，最多 60 个交易日
page	默认 1，每页 50 条

data[] 字段因 kind 而异：

kind	主要字段
stock	code、name、list_count、buy_total_10k、sell_total_10k、net_10k、buy_seats、sell_seats
broker	broker_name、list_count、buy/sell_total_10k、top_buy_stocks
inst	code、name、price、change_pct、inst_buy/sell_total_10k、inst_buy/sell_count、net_10k
inst_detail	code、name、tradedate、inst_buy_10k、inst_sell_10k

meta 含 kind、bdate、edate、days、page、count、total。

公共字段（daily/stock）

字段	说明
code / name	股票代码、简称
close / metric_pct	收盘价、涨跌幅（%）
volume_10k_shares / amount_10k_cny	成交量（万股）、成交额（万元）
type	榜单类型
reason	上榜原因
tradedate	交易日期
detail.buy / detail.sell	席位明细

席位明细（with_details=1）每项含 broker_code、broker_name、买卖金额（*_amount_10k_cny）、net_amount_10k_cny；开启标注时含 hot_money（游资名称数组）。

停复牌 {#suspend}

停复牌数据（scope：suspend）。

GET /v1/suspend
GET /v1/suspend/daily?date=20260815
GET /v1/suspend/stock?symbol=600519.SS
GET /v1/suspend/dates

路径	说明
`/v1/suspend`	当前停牌
`/v1/suspend/daily`	日事件
`/v1/suspend/stock`	单票区间
`/v1/suspend/dates`	有数据的日期

个股资金流向 {#moneyflow}

GET /v1/moneyflow/daily-trend?symbol=600519.SS&bdate=2025-01-01&edate=2025-06-01&limit=100
GET /v1/moneyflow/stage?symbol=600519.SS
GET /v1/moneyflow/distribution?symbol=600519.SS
GET /public/v1/moneyflow/schema

需 moneyflow 权限（开通状态见 GET /v1/me）。仅支持沪深 A 股。字段说明见 GET /public/v1/moneyflow/schema（无需 Key）。

日资金流入趋势 {#moneyflow-daily-trend}

GET /v1/moneyflow/daily-trend — 日级净流入、占比、主力净额等。

字段	说明
date	交易日
trade	收盘价
changeratio	涨跌幅（%）
turnover	成交额
netamount	净流入额
ratioamount	净流入占比（%）
r0_net	主力净额
r0_ratio	主力净占比（%）
r0x_ratio	主力/散户净占比（%）
cnt_r0x_ratio	主力/散户计数比
cate_ra / cate_na	分类占比

阶段主力动向 {#moneyflow-stage}

GET /v1/moneyflow/stage — 3/5/10 日阶段主力净额与占比。

字段	说明
date	交易日
r0_net_3 / r0_ratio_3 / r0x_ratio_3	3 日主力净额、占比
r0_net_5 / r0_ratio_5 / r0x_ratio_5	5 日
r0_net_10 / r0_ratio_10 / r0x_ratio_10	10 日

历史成交分布 {#moneyflow-distribution}

GET /v1/moneyflow/distribution — 大/中/小/散单成交与净额分布。

字段	说明
date	交易日
trade / changeratio / turnover	价、涨跌幅、成交额
netamount / ratioamount	净流入额、占比
r0~r3	大/中/小/散单成交额
r0_net~r3_net	对应净额

字段说明 {#moneyflow-schema}

GET /public/v1/moneyflow/schema — 三表字段定义（无需 Key）。

公共参数：

参数	必填	说明
symbol	是	股票代码
date	否	单个交易日 YYYY-MM-DD（与 bdate/edate 互斥）
bdate / start	否	起始日 YYYY-MM-DD
edate / end	否	结束日 YYYY-MM-DD
limit	否	最多返回条数，默认 100，最大 500；`bdate`~`edate` 跨度最多 10 日（含首尾）

未指定日期时按 limit 返回最近有数据的交易日（默认 100，最大 500）。显式 bdate/edate 跨度最多 10 自然日。date 与 bdate/edate 不可同时使用。

data[] 每项含 date 及对应数值字段（字符串）。meta 含 symbol、dataset、label、count、as_of。无数据时 404；数据暂不可用时 503。

新浪资金流排名（当日盘中快照） {#moneyflow-ranking}

新浪资金流排名：交易时段的板块与个股资金流向排行。仅当前业务日（09:15 前为上一交易日），不支持 date / bdate / edate / capture_id（传参返回 400）。需 moneyflow 权限。响应 meta.source=sina、meta.source_label=新浪。

GET /v1/moneyflow/ranking/boards?category=industry&limit=50
GET /v1/moneyflow/ranking/stocks/net?sort=netamount&limit=100
GET /v1/moneyflow/ranking/stocks/main?sort=r0_net&limit=100
GET /v1/moneyflow/ranking/stocks/retail?sort=r3_net&limit=100
GET /v1/moneyflow/ranking/snapshot
GET /public/v1/moneyflow/ranking/catalog

板块榜 {#moneyflow-ranking-boards}

GET /v1/moneyflow/ranking/boards — category 必填：industry / concept / csrc_industry；可选 limit。板块代表股 ts_symbol 为标准代码（如 600519.SS）。

身份为板块 名称 + category，不是站内 plate_id。按站内板块查资金流请用 GET /v1/plate/moneyflow（需 plate_moneyflow）。

个股榜 {#moneyflow-ranking-stocks}

三类个股榜，按业务含义拆分字段；sort 选择按额或按率。可选 symbol（如 600519.SS）查单票；data[] 仅含标准 symbol。

路径	类	`sort`	主要字段
`/v1/moneyflow/ranking/stocks/net`	净流入	`netamount`（默认）、`ratioamount`	in/out/net/ratioamount
`/v1/moneyflow/ranking/stocks/main`	主力	`r0_net`（默认）、`r0_ratio`	r0_in/out/net/ratio
`/v1/moneyflow/ranking/stocks/retail`	散户	`r3_net`（默认）、`r3_ratio`	r3_in/out/net/ratio

金额类字段单位为元；changeratio / *ratio 为小数比例；turnover 为换手万分比（÷100 为 %）；r0x_ratio 为主力罗盘（度）。

旧路径 GET /v1/moneyflow/ranking/stocks?sort=…（六种 sort、全字段）响应 meta.deprecated=true，请改用上表三类路径。

快照信息 {#moneyflow-ranking-snapshot}

GET /v1/moneyflow/ranking/snapshot — 返回当前业务日更新时间与板块/个股行数统计，无参数。

排行目录 {#moneyflow-ranking-catalog}

GET /public/v1/moneyflow/ranking/catalog — 可选参数与字段说明，无需 Key。

响应 meta 含 trade_date（当前业务日）、captured_at（YYYY-MM-DD HH:MM:SS 北京时间）、snapshot_policy=today_intraday、source / source_label。

东财资金流排名（当日盘中快照） {#moneyflow-ranking-em}

东财资金流排名：全市场个股资金流排行（今日四档 + 5/10 日主力字段）。仅当前业务日（09:15 前为上一交易日），不支持 date / bdate / edate / capture_id。需 moneyflow 权限。响应 meta.source=eastmoney、meta.source_label=东财。

GET /v1/moneyflow/ranking/em/stocks?sort=main_net&limit=100
GET /v1/moneyflow/ranking/em/snapshot
GET /public/v1/moneyflow/ranking/em/catalog

个股榜 {#moneyflow-ranking-em-stocks}

GET /v1/moneyflow/ranking/em/stocks — 可选 sort（默认 main_net）、limit、symbol。

常用 sort：main_net / main_net_ratio / super_net / large_net / medium_net / small_net / rank_today / main_net_5d / main_net_10d 等（完整列表见 catalog）。rank_* 升序，其余降序。金额单位为元；占比/涨跌幅为小数。

快照信息 {#moneyflow-ranking-em-snapshot}

GET /v1/moneyflow/ranking/em/snapshot — 返回当前业务日更新时间与个股行数，无参数。

排行目录 {#moneyflow-ranking-em-catalog}

GET /public/v1/moneyflow/ranking/em/catalog — sort 与字段说明，无需 Key。

游资名录 {#hot-money}

GET /v1/hot-money
GET /v1/hot-money?name=赵老哥
GET /v1/hot-money?keyword=章
GET /v1/hot-money?q=章
GET /v1/hot-money/stats?lastdays=5&page=1
GET /v1/hot-money/stats?name=赵老哥&bdate=2025-06-16&edate=2025-06-20
GET /v1/hot-money/detail?name=赵老哥&lastdays=5
GET /v1/hot-money/detail?symbol=600519.SS&lastdays=5
GET /v1/hot-money/seat?broker=中信证券上海溧阳路
GET /v1/hot-money/seat?seat=中信证券上海溧阳路

需 hot_money 权限（开通状态见 GET /v1/me）。查询知名游资及其常用营业部；支持按名称精确查询、关键词搜索（keyword 或 q）、按龙虎榜席位关联做统计与明细反查、按营业部反查（broker 或 seat）。名录未就绪时返回 503。

字段	说明
name	游资名称
desc	简要说明
intro	详细介绍
seats	关联营业部名称列表

参数 limit 默认 50，最大 200（列表/搜索时有效）。name 与 keyword 不可同时使用。

/v1/hot-money/seat 响应 data 含 broker、hot_money（名称列表）、traders（完整条目数组）。

统计 `/v1/hot-money/stats`

按龙虎榜席位关联知名游资，区间内聚合上榜次数与买卖额排行。

参数	说明
lastdays	默认 5，统计最近 N 个含买卖席位明细的交易日（与 bdate/edate 二选一）；最大 5
bdate + edate	指定区间，最多 5 个含席位明细的交易日
page	默认 1，每页 50 条
name	可选，只看某一游资

data[] 主要字段：name、list_count、buy_total_10k、sell_total_10k、net_10k、buy_seats、sell_seats、top_buy_stocks。meta 含 bdate、edate、days、page、count、total。

反查 `/v1/hot-money/detail`

按游资名称与/或股票代码查询上榜明细（须至少提供其一）。日期参数同统计。

参数	说明
name	游资名称
symbol	股票代码
lastdays / bdate + edate / page	同统计（区间最多 5 个交易日）

data[] 一行 = 交易日 × 股票 × 游资：tradedate、code、stock_name、name、buy_amount_10k_cny、sell_amount_10k_cny、net_amount_10k_cny、brokers、reason。