Cn Market Mechanics

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

    cp -r skills/cn-market-mechanics ~/.openclaw/skills/
---

# CN Market Mechanics — A股市场机制

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

## Curl Setup

```bash
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`） |

---

## 调用示例

```bash
# 涨跌停价格
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` |