undermybelt CN Kline — A股K线数据
所有接口均为 V2 版本（
/api/v2/...）。
Curl Setup
BASE="http://43.167.234.49:3101"
AUTH=(-H "X-API-Key: 123456" -H "Content-Type: application/json")
代码格式规则
| 规则 | 值 |
|---|---|
| 参数名 | symbol |
| 代码格式 | 带交易所后缀 |
| 日期格式 | YYYYMMDD |
| 市场 | 示例 |
|---|---|
| 上交所 (SH) | 600519.SH |
| 深交所 (SZ) | 000001.SZ |
| 北交所 (BJ) | 430047.BJ |
❌ 错误写法：600519（纯数字）、SH600519
端点详情
GET /api/v2/cnstock/stocks
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
symbol |
string | Yes | 股票代码（带后缀） | 000001.SZ |
interval |
string | No | daily (默认), weekly, monthly |
daily |
startDate |
string | No | YYYYMMDD | 20240101 |
endDate |
string | No | YYYYMMDD | 20240131 |
limit |
int | No | 1-5000 (默认 100) | 500 |
调用示例
# 最近100根日线（默认）
curl -sS "${AUTH[@]}" "$BASE/api/v2/cnstock/stocks?symbol=000001.SZ"
# 指定区间
curl -sS "${AUTH[@]}" "$BASE/api/v2/cnstock/stocks?symbol=000001.SZ&startDate=20240101&endDate=20240131"
# 周线
curl -sS "${AUTH[@]}" "$BASE/api/v2/cnstock/stocks?symbol=600519.SH&interval=weekly&limit=50"
# 月线
curl -sS "${AUTH[@]}" "$BASE/api/v2/cnstock/stocks?symbol=300750.SZ&interval=monthly&limit=24"
# 多股票K线并行
curl -sS "${AUTH[@]}" "$BASE/api/v2/cnstock/stocks?symbol=002594.SZ&limit=10" &
curl -sS "${AUTH[@]}" "$BASE/api/v2/cnstock/stocks?symbol=300750.SZ&limit=10" &
wait
响应示例：
{
"symbol": "000001.SZ",
"interval": "daily",
"data": [
{"time": 1704067200000, "open": 10.50, "high": 10.80, "low": 10.40, "close": 10.70, "volume": 1234567, "adjFactor": 1.0}
],
"total": 500
}
错误排查
| 错误 | 原因 | 修复 |
|---|---|---|
| 404 | symbol 格式错误 | 用 600519.SH，不要 600519 |
| 空数据 | 日期区间无交易日 | 检查日期范围是否合理 |
| 400 | 日期格式错误 | 用 YYYYMMDD，如 20240101 |