悟道 · A股涨停板#

提供 9 个涨停板相关接口，覆盖短线打板交易的完整数据需求：梯队、筛选、溢价、炸板池、跌停池、冲刺涨停、统计、最强风口、事件流。

Instructions for the hosting agent#

1. 环境变量：若缺少 LB_API_KEY 或 LB_API_BASE，先提示用户按下方 Setup 配置。
2. 仅使用本文「Endpoints」中列出的路径与参数，勿臆造接口。

Setup#

获取 API Key#

1. 访问 https://stock.quicktiny.cn 注册账号并登录
2. 进入「开发者 API」页面（路径： /developer）
3. 点击「创建密钥」，系统会生成一个以 lb_ 开头的 API Key
4. 立即复制保存，密钥仅显示一次

配置环境变量#

bash

export LB_API_KEY="lb_your_key_here"
export LB_API_BASE="https://stock.quicktiny.cn/api/openclaw"

Authentication#

bash

curl -s -H "Authorization: Bearer $LB_API_KEY" "$LB_API_BASE/endpoint"

Endpoints#

1. 涨停梯队 ⭐#

核心功能。展示连板梯队（1板、2板、3板…最高板）及每层的个股详情。

bash

curl -s -H "Authorization: Bearer $LB_API_KEY" "$LB_API_BASE/ladder?date=20260320"
curl -s -H "Authorization: Bearer $LB_API_KEY" "$LB_API_BASE/ladder?date=2026-03-20"

参数： date*（YYYYMMDD 或 YYYY-MM-DD）。

返回结构：

json

{
  "dateRange": "2026-03-20 至 2026-03-20",
  "dates": [
    {
      "date": "20260320",
      "dayOfWeek": "周五",
      "totalStocks": 28,
      "pauseRatio": 0.7,
      "boards": [
        { "level": 6, "stocks": [...] },
        { "level": 3, "stocks": [...] },
        { "level": 1, "stocks": [...] }
      ],
      "isRealtime": true,
      "limitUpCount": { "today": { "num": 28, "history_num": 51, "rate": 0.549, "open_num": 23 }, "yesterday": {...} },
      "limitDownCount": {...},
      "tradeStatus": { "id": "afternoon_trade", "name": "交易中" }
    }
  ]
}

boards 按 level（连板天数） 降序 排列。 limitUpCount/ limitDownCount/ tradeStatus 仅盘中实时数据有。

每只股票的关键字段：

字段说明name, code股票名称和代码level, continue_num连板天数price, change（字符串，含单位）显示用价格和涨幅latest, change_rate数值型价格和涨幅first_limit_up_time, last_limit_up_time首次/最后封板时间（HH:MM:SS）limit_up_type涨停类型（换手板/一字板等）open_num开板次数order_volume, order_amount封单量/封单额currency_value, turnover_rate流通市值/换手率reason_type涨停原因关键词reason_info涨停详细分析（AI 生成，100-300字）industry所属行业jiuyangongshe_category_name扩展概念分类jiuyangongshe_analysis题材扩展解读tags[]自动标签（如"总龙头""高标龙""题材龙""中军""一字龙"等）is_margin是否融资融券标的is_new, is_again_limit是否新股/是否回封

分析思路： level 最高的是空间板，决定市场高度； tags 含"总龙头"的是核心标的； first_limit_up_time 越早越强势； open_num 为 0 代表一封到底。

2. 涨停筛选#

多维度筛选历史涨停股数据。

bash

curl -s -H "Authorization: Bearer $LB_API_KEY" "$LB_API_BASE/limit-up/filter?date=2026-03-20&continueNumMin=2&limit=50"
curl -s -H "Authorization: Bearer $LB_API_KEY" "$LB_API_BASE/limit-up/filter?date=2026-03-20&reasonType=人工智能"

参数： date, startDate/ endDate, continueNum, continueNumMin/ continueNumMax, reasonType（模糊匹配）, industry（模糊匹配）, page, limit（默认20，上限100）, sortBy（默认 continue_num）, sortOrder（默认 desc）。

返回 { items[], pagination: { page, pageSize, total, totalPages } }。每只股票字段包含梯队接口的所有字段，额外包括 main_business（主营业务）, business_scope（经营范围）等。

3. 涨停溢价#

分析涨停股次日开盘溢价率，用于评估哪些股打板后有肉吃。

bash

curl -s -H "Authorization: Bearer $LB_API_KEY" "$LB_API_BASE/limit-up/premium?startDate=2026-03-01&endDate=2026-03-20&minLimitUpCount=3"

参数： startDate*, endDate*, minLimitUpCount（默认5）, sortBy（ avgPremium/ totalCount/ positiveRate/ maxContinueNum）, sortOrder, page, limit。

返回 { total, dateRange, stocks[] }。每只股票：

字段类型说明codestring股票代码namestring名称industrystring行业totalCountnumber区间内涨停次数maxContinueNumnumber最大连板数avgPremiumnumber/null平均次日溢价率（%），正=高开，负=低开positiveRatenumber正溢价比例（%）premiumSamplesnumber有效样本数

分析思路： avgPremium > 1% 且 positiveRate > 60% 的股票次日打板有溢价保护。

4. 炸板池 ⭐#

盘中曾触及涨停但未封住的股票。炸板后回封=强势信号，连续炸板=弱势。

bash

curl -s -H "Authorization: Bearer $LB_API_KEY" "$LB_API_BASE/broken-limit-up?date=2026-03-20"

返回结构：

json

{
  "data": {
    "stocks": [...],
    "total": 19,
    "stats": {
      "limitUpCount": { "today": { "num": 24, "history_num": 43, "rate": 0.558, "open_num": 19 }, "yesterday": { ... } },
      "limitDownCount": { "today": { "num": 51, "history_num": 65, "rate": 0.785, "open_num": 14 }, "yesterday": { ... } },
      "tradeStatus": { "id": "afternoon_trade", "name": "交易中", "start_time": "13:00", "end_time": "14:57" }
    }
  }
}

stocks[] 每只股票字段：

字段类型说明codestring股票代码namestring股票名称changePercentnumber当前涨幅（%）pricenumber最新价currencyValuenumber流通市值（元）turnoverRatenumber换手率（%）openNumnumber开板次数（越多说明封不住）firstLimitUpTimenumber首次触及涨停的 Unix 时间戳lastLimitUpTimenumber最后一次触及涨停的 Unix 时间戳limitUpSucRatenumber历史封板成功率changeTagstring"LIMIT_FAILED" =炸板未回封reasonTypestring涨停原因关键词market_idnumber17 =上交所, 33 =深交所

stats 是全市场涨跌停统计快照（today vs yesterday），含 num（封板数）、 history_num（触及总数）、 rate（封板率 0~1）、 open_num（炸板数）。

5. 跌停池#

当前跌停的股票列表。

bash

curl -s -H "Authorization: Bearer $LB_API_KEY" "$LB_API_BASE/limit-down?date=2026-03-20"

返回结构与炸板池完全一致（ stocks[] + stats）。

分析思路：跌停数 > 涨停数是极端弱势信号。跌停池中出现前期强势题材股说明板块退潮。

6. 冲刺涨停#

涨幅接近涨停但尚未触及涨停价的股票。

bash

curl -s -H "Authorization: Bearer $LB_API_KEY" "$LB_API_BASE/approaching-limit-up?date=2026-03-20"

返回结构与炸板池一致。

分析思路：冲刺涨停的股票如果最终封板，往往是尾盘资金抢筹信号。

7. 涨跌停统计 ⭐#

实时涨跌停统计：封板数、触及总数、封板率、炸板数（今日 vs 昨日对比）。

bash

curl -s -H "Authorization: Bearer $LB_API_KEY" "$LB_API_BASE/limit-stats?date=2026-03-20"

返回结构：

json

{
  "data": {
    "limitUp": {
      "today": { "num": 24, "history_num": 43, "rate": 0.558, "open_num": 19 },
      "yesterday": { "num": 28, "history_num": 51, "rate": 0.549, "open_num": 23 }
    },
    "limitDown": {
      "today": { "num": 51, "history_num": 65, "rate": 0.785, "open_num": 14 },
      "yesterday": { "num": 13, "history_num": 19, "rate": 0.684, "open_num": 6 }
    },
    "tradeStatus": { "id": "afternoon_trade", "name": "交易中" },
    "date": "20260323"
  }
}

分析思路：封板率 > 60% = 强势，< 45% = 弱势；今日 vs 昨日对比判断情绪升降温；跌停数突增是恐慌信号。

8. 最强风口 ⭐#

按涨停股聚集度排名的板块列表，含 AI 涨停原因分析。

bash

curl -s -H "Authorization: Bearer $LB_API_KEY" "$LB_API_BASE/hot-sectors?date=2026-03-20"

返回板块数组，每个板块字段：

字段类型说明codestring板块代码namestring板块名称changePercentnumber板块整体涨幅（%）limitUpNumnumber涨停股数量continuousPlateNumnumber连板股数量highBoardstring最高连板描述，如 "2天2板"``daysnumber板块持续活跃天数stocks[]array涨停股列表

stocks[] 每只股票： code, name, changePercent, price, continueNum, highDays, reasonType（简因）, reasonInfo（AI 详细分析 100-300字）, changeTag, isSt, isNew。

分析思路： days 越大题材持续性越强； continuousPlateNum > 0 有连板支撑，是主线方向。

9. 封板/炸板事件流 ⭐#

盘中实时封板/炸板事件流，精确到秒级。

bash

curl -s -H "Authorization: Bearer $LB_API_KEY" "$LB_API_BASE/limit-events?type=limit_up"
curl -s -H "Authorization: Bearer $LB_API_KEY" "$LB_API_BASE/limit-events?type=limit_down"

type: limit_up（默认）或 limit_down。无需传 date，返回当日盘中实时数据。

返回 { events[], total }。数组按 time 倒序（最新在前），通常数百条。

json

{
  "code": "002896", "name": "中大力德",
  "type": "LIMIT_BACK",
  "orderVolume": "124000.000", "orderAmount": "9548000.0",
  "turnover": "725580960.0", "time": 1774247310
}

字段类型说明code, namestring股票代码/名称typestring"LIMIT_BACK" = 封板; "LIMIT_FAILED" = 炸板orderVolumestring封单量（股）。 字符串。炸板时为 "0"``orderAmountstring封单金额（元），字符串turnoverstring累计成交额（元），字符串timenumberUnix 时间戳（秒）

重要特征：

• 数值字段（ orderVolume、 orderAmount、 turnover）均为 字符串类型
• 同一股票反复出现： LIMIT_BACK → LIMIT_FAILED 交替
• 最终事件为 LIMIT_BACK = 收盘封板， LIMIT_FAILED = 最终炸板

分析思路：按股票分组统计封板 vs 炸板次数得出"封板成功率"；封/炸 > 10次说明多空极度分裂；一封到底零炸板的是最强标的。

Response Format#

成功： { "success": true, "data": {...}, "meta": {...} } 失败： { "success": false, "error": "ERROR_CODE", "message": "..." }

Error Codes#

CodeHTTP说明MISSING_API_KEY401未提供 API KeyINVALID_API_KEY401Key 无效KEY_EXPIRED403Key 已过期RATE_LIMIT_EXCEEDED429限流MISSING_PARAM400缺少必填参数INVALID_PARAM400参数格式错误

Notes#

• 日期格式：同时支持 YYYY-MM-DD 和 YYYYMMDD
• A 股交易时间：9:15-15:00（北京时间）
• 查询当日数据前建议先用交易日历确认是否为交易日