Market Stock Skill

Version: v2.5.0

A股/港股/美股行情数据、27种技术指标、结构化金融研报生成。

Requirements

• MARKETAPIBASE_URL — API server URL
• MARKETAPIKEY — API key for authentication

Curl Setup

BASE="${MARKET_API_BASE_URL%/}"
AUTH=(-H "X-API-Key: $MARKET_API_KEY" -H "Content-Type: application/json")

不要自己编造接口

核心规则：只能调用下方 Quick Route 表和 references/ 中列出的端点。不确定时先查 references/，不要猜。

Quick Route

行情数据

技术指标

Critical Rules

1. 代码格式 — 最常见错误来源

速记：securities 用纯代码 + codes，K线用 symbol，其余用 tsCode。

# ✅ securities → 纯代码，codes
curl "$BASE/api/v2/cnstock/securities?codes=600519,000001"
# ✅ K线 → 带后缀，symbol
curl "$BASE/api/v2/cnstock/stocks?symbol=600519.SH&limit=10"
# ✅ 公司信息 → 带后缀，tsCode
curl "$BASE/api/v2/cnstock/company?tsCode=600519.SH"

2. 日期格式

3. 指标参数对照 — exchange vs market vs codes

三套接口使用不同的交易所标识方式，混用会报错（如 "unknown exchange"）：

⚠️ 指标接口没有 exchange 参数。 传 exchange=SSE / exchange=SZSE 等会返回 "unknown exchange" 错误。正确做法是用 market 参数：

# ✅ 正确：用 market
curl "$BASE/api/v2/indicators/rsi?market=cn&symbol=600519.SH&period=14&limit=100"

# ❌ 错误：指标接口没有 exchange 参数
curl "$BASE/api/v2/indicators/rsi?exchange=SSE&symbol=600519.SH&period=14&limit=100"

market 必填: cn（A股）、hk（港股）、us（美股）。

4. 港股 limit 已知问题

/api/v2/hkstock/stocks 的 limit 可能不返回最新交易日。改用 startDate + endDate。

# ✅ 港股指标：只传 market=hk，不传 exchange
curl "$BASE/api/v2/indicators/rsi?market=hk&symbol=00700.HK&period=14&limit=100"

# ❌ 错误：股票不需要 exchange
curl "$BASE/api/v2/indicators/rsi?market=hk&symbol=00700.HK&exchange=HKEX&period=14&limit=100"

5. API Boundary — 只用文档中列出的端点

NEVER guess or fabricate API endpoints. Only use endpoints explicitly listed in the Quick Route table above. The following endpoints DO NOT EXIST — do not call them:

/api/v2/cnstock/industry · /api/v2/cnstock/industry/daily · /api/v2/cnstock/sector · /api/v2/cnstock/financial · /api/v2/cnstock/profile · /api/v2/cnstock/info · /api/v2/cnstock/report · /api/v2/cnstock/summary

If the data you need is not in Quick Route, tell the user and suggest tavily to search for it.

6. 技术指标：股票用 GET 并行，不要用 POST 批量

POST /api/v2/indicators 批量接口只支持 crypto（参数是 exchange 不是 market），不支持股票。 股票指标必须用 GET /api/v2/indicators/{type} 单指标接口，多个指标并行调用。

# ✅ 正确：股票用 GET 单指标，多个并行发出
curl "$BASE/api/v2/indicators/rsi?market=hk&symbol=00700.HK&period=14&limit=100" &
curl "$BASE/api/v2/indicators/macd?market=hk&symbol=00700.HK&limit=100" &
curl "$BASE/api/v2/indicators/boll?market=hk&symbol=00700.HK&period=20&nbdev=2.0&limit=100" &
wait

# ❌ 错误：股票用 POST 批量接口（会报 422，要求 exchange）
curl -X POST "$BASE/api/v2/indicators" -d '{"market":"hk","symbol":"00700.HK",...}'

7. 并行调用 — 不要串行等待

K线数据和指标数据没有依赖关系，应该并行调用。不要等 K 线返回后再调指标。

✅ 并行：klines + GET /indicators/{type} + daily-basic 同时发出
❌ 串行：先 klines → 等返回 → 再 indicators → 等返回 → 再 daily-basic

8. 港股日线禁用 limit，必须用 startDate/endDate

港股 /api/v2/hkstock/daily 的 limit 参数有 bug：返回数据会缺少最新交易日。港股日线必须用 startDate/endDate 取数据，不要用 limit。

# ✅ 正确：用日期范围
curl -sS "${AUTH[@]}" "$BASE/api/v2/hkstock/daily?symbol=00700.HK&startDate=20260301&endDate=20260405"

# ❌ 有 bug：limit 会丢失最新交易日数据
curl -sS "${AUTH[@]}" "$BASE/api/v2/hkstock/daily?symbol=00700.HK&limit=30"

9. 不要直接爬取外部网页

10. Alpha Vantage 频率限制 — 75 次/分钟

Quick Route 中标记 [AV] 的端点走 Alpha Vantage 数据源，共享 75 次/分钟 配额。

消耗预算估算：

规则：

• 单轮对话中最多分析 2-3 只股票，避免触发 429
• analysis 和 fundamental-analysis 是编排接口（内部多次调用 AV），不要并行调用，且不要在同一轮与其他 AV 接口并行
• 非 [AV] 端点（securities、stocks、symbols、indicators）不受此限制，可自由并行
• 收到 429 → 立即停止所有 AV 调用，不要重试

DO NOT directly fetch external websites (sina.com.cn, wallstreetcn.com, cninfo.com.cn, cls.cn, 36kr.com, etc.) — most will fail (JS rendering, anti-scraping, 404). Use the correct skill:

Call Strategy — 性能关键

规则 1：并行优先

无依赖关系的 API 调用必须并行：

# 多股票K线并行
curl "$BASE/api/v2/cnstock/stocks?symbol=002594.SZ&limit=10" &
curl "$BASE/api/v2/cnstock/stocks?symbol=300750.SZ&limit=10" &
wait

# 多指数并行
curl "$BASE/api/v2/cnstock/index/daily?tsCode=000001.SH&limit=5" &
curl "$BASE/api/v2/cnstock/index/daily?tsCode=399001.SZ&limit=5" &
wait

并行场景：多只股票K线、多个指数、不同股票指标、行情+新闻、同股K线+指标。

规则 2：多指标用 GET 并行（股票）

股票指标不支持 POST 批量接口（POST 只支持 crypto）。多个指标用 GET 单接口并行调用：

# ✅ 股票：GET 并行，多个指标同时发出
curl "$BASE/api/v2/indicators/rsi?market=cn&symbol=000001.SZ&period=14&limit=100" &
curl "$BASE/api/v2/indicators/macd?market=cn&symbol=000001.SZ&limit=100" &
curl "$BASE/api/v2/indicators/boll?market=cn&symbol=000001.SZ&period=20&nbdev=2.0&limit=100" &
curl "$BASE/api/v2/indicators/kdj?market=cn&symbol=000001.SZ&limit=100" &
wait

# ❌ 错误：股票用 POST 批量会报错（要求 exchange 参数，股票没有）
curl -X POST "$BASE/api/v2/indicators" -d '{"market":"cn","symbol":"000001.SZ",...}'

规则 3：404 立即停止

收到 404 → 检查黑名单，不重试，不推测新端点。

Report Generation Workflow

原则：有数据有观点，不要废话。总字数不超过 800 字。

Step 1: Cluster — 聚类为 2-3 个核心主题（不要超过 3 个）

Step 2: Write — 每个主题：数据表格/图表 + 1-2 段分析（带观点）

Step 3: Assemble — 组装格式：

• 开头一句话结论（带 🟢🔴🟡 标签）
• 2-3 个主题段落（每段含表格或 json-chart）
• 风险提示（1-2 句）
• 没有 Executive Summary，开头结论就是 Summary

Error Troubleshooting

详细排错表见 references/ERRORS.md。常见错误速查：

Error Codes: 400 参数错误 · 401 API key 无效 · 404 标的不存在 · 500 内部错误

References

• references/CNSTOCK-API.md — A股行情 + 指数
• references/HKSTOCK-API.md — 港股行情 + 港股通
• references/USSTOCK-API.md — 美股行情 + 市场信息 + 财务数据
• references/INDICATORS-API.md — 27种技术指标详参

参数不确定时：grep -r "关键词" references/