- name
- wudao-market
- version
- 1.0.0
- description
- 悟道 · A股行情数据：股票搜索、K线、分时、排行榜、市场概况、交易日历。Use when: user asks about A股, stock search, K-line charts, minute data, stock rankings, market overview, trading calendar, or basic A-share market data. NOT for: limit-up board analysis, capital flow, sector rotation, or news intelligence.
- metadata
悟道 · A股行情数据
提供 6 个 A 股基础行情接口：股票搜索、K线、分时、排行榜、市场概况、交易日历。
Instructions for the hosting agent
- 环境变量：若缺少
LB_API_KEY或LB_API_BASE，先提示用户按下方 Setup 配置，不要猜测 Base URL。 - 仅使用本文「Endpoints」中列出的路径与参数，勿臆造接口。
Setup
获取 API Key
- 访问 https://stock.quicktiny.cn 注册账号并登录
- 进入「开发者 API」页面（路径：
/developer） - 点击「创建密钥」，系统会生成一个以
lb_开头的 API Key - 立即复制保存，密钥仅显示一次
配置环境变量
export LB_API_KEY="lb_your_key_here"
export LB_API_BASE="https://stock.quicktiny.cn/api/openclaw"Authentication
curl -s -H "Authorization: Bearer $LB_API_KEY" "$LB_API_BASE/endpoint"Endpoints
1. 股票搜索
按名称、代码、行业、拼音搜索股票。
curl -s -H "Authorization: Bearer $LB_API_KEY" "$LB_API_BASE/search?query=茅台&limit=10"参数：query*（搜索词，支持名称/代码/行业/拼音首字母）, limit（最大返回数，默认20，上限50）。
返回 { items[], total }。每只股票字段：ts_code（如 600519.SH）, symbol（如 600519）, name, area（地区）, industry（行业）, market（主板/创业板/科创板）, list_status（L=上市）, list_date（上市日期 YYYYMMDD）。
2. K线数据
获取合并的历史+实时K线。代码格式：600519 或 600519.SH。支持个股和指数（如 000001.SH 上证指数）。
curl -s -H "Authorization: Bearer $LB_API_KEY" "$LB_API_BASE/kline/600519?days=30"
curl -s -H "Authorization: Bearer $LB_API_KEY" "$LB_API_BASE/kline/600519?days=60&endDate=2026-03-20"参数：code*（路径参数）, days（K线天数，默认15）, endDate（截止日期）。
返回 K 线数组，每根 K 线字段：
| 字段 | 类型 | 说明 |
|---|---|---|
date | string | YYYYMMDD |
open | number | 开盘价 |
high | number | 最高价 |
low | number | 最低价 |
close | number | 收盘价 |
volume | number | 成交量（股） |
amount | number | 成交额（元） |
pre_close | number | 昨收价（部分数据源可能缺失） |
change | number | 涨跌额 |
pct_chg | number | 涨跌幅（%） |
注意：盘中「今日」K线来自实时行情合并结果，可能缺少 pre_close/change/pct_chg。
3. 分时数据
分钟级分时数据，来自实时行情接口。
curl -s -H "Authorization: Bearer $LB_API_KEY" "$LB_API_BASE/minute/600519?ndays=1"参数：code*（路径参数）, ndays（天数，默认1）。
返回接口原始格式。核心数据在 data.trends 数组中，每条是逗号分隔的字符串（非 JSON 对象）：
"2026-03-20 09:31,1800.00,1805.50,1810.00,1798.00,1234,22300000.00,1803.20"字段顺序：时间, 开盘, 最新价, 最高, 最低, 成交量(手), 成交额, 均价。解析时需 split(',') 并 parseFloat。
data.prePrice 为昨收价，可用于计算涨跌幅。
4. 股票排行
多维度股票排行榜。
curl -s -H "Authorization: Bearer $LB_API_KEY" "$LB_API_BASE/rank?type=gainers&market=all&limit=20"参数：
type：gainers（涨幅）,losers（跌幅）,volume,turnover_rate,amount,gainers_Nd/losers_Nd（N=3/5/10/20日涨跌幅）,intraday_drawdown,intraday_profit,overnight_drawdown,overnight_profitmarket：all（默认）,main,gem,starlimit：默认50，上限200
返回排行数组，每只股票字段：rank, code, name, price（收盘价）, changePercent（涨跌幅%）, amount（成交额，元）, turnoverRate（换手率，可能为 null）, high, low, open, preClose, amplitude（振幅%）, volumeRatio。
N 日排行额外返回 metricValue（N日累计涨跌幅%），但不含 high/low 等日内字段。
5. 市场概况
每日市场总览，判断大盘强弱的核心数据。
curl -s -H "Authorization: Bearer $LB_API_KEY" "$LB_API_BASE/market-overview?date=2026-03-20"参数：date*（YYYY-MM-DD）。
返回字段：
| 字段 | 类型 | 说明 |
|---|---|---|
date | string | YYYY-MM-DD |
rise_count | number | 上涨家数 |
fall_count | number | 下跌家数 |
limit_up_count | number | 涨停家数 |
limit_down_count | number | 跌停家数 |
limit_up_broken_count | number | 炸板家数 |
limit_up_broken_ratio | number | 炸板率 |
yesterday_limit_up_avg_pcp | number | 昨日涨停股今日平均涨幅（衡量接力意愿） |
market_temperature | number | 市场温度（综合情绪指标） |
分析思路：rise_count vs fall_count 判断多空力量；yesterday_limit_up_avg_pcp > 0 说明市场有赚钱效应；market_temperature 越高市场越活跃。
6. 交易日历
查询某天是否为交易日。
curl -s -H "Authorization: Bearer $LB_API_KEY" "$LB_API_BASE/trading-calendar?date=2026-03-20"参数：date*（YYYY-MM-DD 或 YYYYMMDD）。
返回：{ date, isTradingDay: true/false, pretrade_date: "YYYYMMDD" }。pretrade_date 为前一个交易日。
Response Format
成功：{ "success": true, "data": {...}, "meta": {...} } 失败：{ "success": false, "error": "ERROR_CODE", "message": "..." }
Error Codes
| Code | HTTP | 说明 |
|---|---|---|
MISSING_API_KEY | 401 | 未提供 API Key |
INVALID_API_KEY | 401 | Key 无效 |
KEY_EXPIRED | 403 | Key 已过期 |
RATE_LIMIT_EXCEEDED | 429 | 限流 |
MISSING_PARAM | 400 | 缺少必填参数 |
INVALID_PARAM | 400 | 参数格式错误 |
Notes
- 日期格式：大多数接口同时支持
YYYY-MM-DD和YYYYMMDD - 股票代码：6 位数字（
600519）或完整代码（600519.SH） - A 股交易时间：9:15-15:00（北京时间），K 线盘中每 9 秒更新
- 查询当日数据前建议先用交易日历确认是否为交易日