涨停专题 {#limit-up}

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

套餐与试用 {#limit-up-tiers}

试用计数规则：

• 各 /v1/limit-up* 接口独立计数，每个接口每日 2 次试用（含沙盒）。
• 额度按 UTC+8 自然日 零点重置。
• 试用仅用于评估接口形态与字段，不建议用于生产轮询；正式接入请升级 旗舰版。
• 超出试用额度时响应示例：{ "success": false, "code": 429, "message": "涨停专题试用额度已用尽（2 次/日），请升级旗舰版" }

GET /v1/me 与 GET /public/v1/catalog 的 scope_rows 可查看当前 Key 是否含 limit_up 及所属套餐。

接口一览 {#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：

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

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

• 订阅模式：客户端发起 GET 并保持长连接（SSE），服务端在有新异动时推送；不是轮询历史接口。
• 同一 API Key 并发订阅数见 GET /v1/me 的 max_abnormal_events_subscriptions（基础 1、专业 2、旗舰 5，可在角色中配置）；超出上限时顶掉最早建立的连接，被顶掉端收到 {"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 为全部类型目录。

字段说明：

龙虎榜 {#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/lhb（参数与 daily / stock 相同）。

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

无数据时返回 404。

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

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

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

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

data[] 字段因 kind 而异：

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

公共字段（daily/stock）

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

个股资金流向 {#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 权限（专业版、旗舰版）。仅支持沪深 A 股。字段说明见 GET /public/v1/moneyflow/schema（无需 Key）。

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

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

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

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

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

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

字段说明 {#moneyflow-schema}

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

公共参数：

未指定日期时默认返回最近可用交易日。date 与 bdate/edate 不可同时使用。

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

游资名录 {#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/seat?broker=中信证券上海溧阳路
GET /v1/hot-money/seat?seat=中信证券上海溧阳路

需 hot_money 权限（专业版、旗舰版）。查询知名游资及其常用营业部；支持按名称精确查询、关键词搜索（keyword 或 q）、按营业部反查（broker 或 seat）。名录未就绪时返回 503。

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

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