| name | cn-realtime-quote |
| description | A股实时行情查询。批量获取沪深京三市证券实时报价。 当用户询问"茅台实时价格""沪深实时行情""A股报价""股票现价"时触发。
|
| user-invocable | true |
| metadata | {"openclaw":"1.0.0","emoji":"📊","install":"# OpenClaw\n\ncp -r skills/cn-realtime-quote ~/.openclaw/skills/\n"} |
CN Realtime Quote — A股实时行情
所有接口均为 V2 版本(/api/v2/...)。
Curl Setup
BASE="http://43.167.234.49:3101"
AUTH=(-H "X-API-Key: 123456" -H "Content-Type: application/json")
代码格式规则
| 规则 | 值 |
|---|
| 参数名 | codes |
| 代码格式 | 纯数字,不带交易所后缀 |
| 单次上限 | 500 个代码 |
| 分隔符 | 英文逗号 |
| 市场 | 示例 |
|---|
| 上交所 (SH) | 600519 |
| 深交所 (SZ) | 000001 |
| 北交所 (BJ) | 430047 |
❌ 错误写法:600519.SH、SH600519、sh600519
端点详情
GET /api/v2/cnstock/securities
批量查询 A股 实时报价。
| Parameter | Type | Required | Description |
|---|
codes | string | Yes | 证券代码,逗号分隔(如 600519,000001,300750) |
fields | string | No | 返回字段,逗号分隔(不传返回全部) |
调用示例
curl -sS "${AUTH[@]}" "$BASE/api/v2/cnstock/securities?codes=600519"
curl -sS "${AUTH[@]}" "$BASE/api/v2/cnstock/securities?codes=600519,000001,300750"
curl -sS "${AUTH[@]}" "$BASE/api/v2/cnstock/securities?codes=600519&fields=price,chgPct,volume"
curl -sS "${AUTH[@]}" "$BASE/api/v2/cnstock/securities?codes=600519" &
curl -sS "${AUTH[@]}" "$BASE/api/v2/cnstock/securities?codes=000001" &
wait
响应示例:
{
"success": true,
"data": {
"600519": {
"name": "贵州茅台",
"price": 1688.50,
"chgPct": 1.25,
"volume": 3500000,
"high": 1695.00,
"low": 1675.00,
"open": 1680.00
}
},
"timestamp": 1710865200000
}
错误排查
| 错误 | 原因 | 修复 |
|---|
| 返回空数据 | codes 带了后缀 | 用纯数字:600519,不要 600519.SH |
| 400 | API key 无效 | 联系管理员检查 API Key |
| 部分代码无数据 | 代码不存在或已退市 | 核对代码是否正确 |