cn-market-mechanics

name	cn-market-mechanics
description	A股市场机制数据。涨跌停价格、停复牌信息、新股IPO、交易日历、复权因子。 当用户询问"涨跌停""停复牌""新股IPO""交易日历""复权因子"时触发。
user-invocable	true
metadata	{"openclaw":"1.0.0","emoji":"⚙️","install":"# OpenClaw\n\ncp -r skills/cn-market-mechanics ~/.openclaw/skills/\n"}

CN Market Mechanics — A股市场机制

所有接口均为 V2 版本（/api/v2/...）。

Curl Setup

BASE="http://43.167.234.49:3101"
AUTH=(-H "X-API-Key: 123456" -H "Content-Type: application/json")

---

代码格式规则

规则	值
参数名	tsCode
代码格式	带交易所后缀（如 600519.SH）
日期格式	YYYYMMDD

---

端点详情

GET /api/v2/cnstock/stk-limit — 涨跌停价格

Parameter	Type	Required	Description
tsCode	string	Yes	股票代码（如 600519.SH）

GET /api/v2/cnstock/suspend — 停复牌信息

Parameter	Type	Required	Description
tsCode	string	Yes	股票代码（如 000001.SZ）
suspendDate	string	No	停牌日期 YYYYMMDD
resumeDate	string	No	复牌日期 YYYYMMDD

GET /api/v2/cnstock/new-share — 新股IPO

Parameter	Type	Required	Description
startDate	string	No	起始日期 YYYYMMDD
endDate	string	No	截止日期 YYYYMMDD

GET /api/v2/cnstock/trade-cal — 交易日历

Parameter	Type	Required	Description
exchange	string	No	SSE(上交所), SZSE(深交所)
startDate	string	No	起始日期 YYYYMMDD
endDate	string	No	截止日期 YYYYMMDD
limit	int	No	1-10000 (默认 100)

GET /api/v2/cnstock/adj-factor — 复权因子

Parameter	Type	Required	Description
tsCode	string	Yes	股票代码（如 000001.SZ）

---

调用示例

# 涨跌停价格
curl -sS "${AUTH[@]}" "$BASE/api/v2/cnstock/stk-limit?tsCode=600519.SH"

# 停复牌
curl -sS "${AUTH[@]}" "$BASE/api/v2/cnstock/suspend?tsCode=000001.SZ"

# 新股IPO
curl -sS "${AUTH[@]}" "$BASE/api/v2/cnstock/new-share?startDate=20240101&endDate=20240630"

# 交易日历
curl -sS "${AUTH[@]}" "$BASE/api/v2/cnstock/trade-cal?exchange=SSE&startDate=20240101&endDate=20240331"

# 复权因子
curl -sS "${AUTH[@]}" "$BASE/api/v2/cnstock/adj-factor?tsCode=600519.SH"

# 涨跌停 + 停复牌并行
curl -sS "${AUTH[@]}" "$BASE/api/v2/cnstock/stk-limit?tsCode=600519.SH" &
curl -sS "${AUTH[@]}" "$BASE/api/v2/cnstock/suspend?tsCode=600519.SH" &
wait

---

端点黑名单

❌ 不存在的端点	✅ 替代方案
/api/v2/cnstock/summary	用 daily-basic 获取市场概览

---

错误排查

错误	原因	修复
404	端点路径错误	不要用 /summary 或 /financial
空数据	tsCode 格式错误	用 600519.SH，不要 600519
400	日期格式错误	用 YYYYMMDD