cn-realtime-quote
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseCN Realtime Quote — A股实时行情
CN Realtime Quote — A-share Real-time Market
所有接口均为 V2 版本()。/api/v2/...
All interfaces are V2 version ()./api/v2/...
Curl Setup
Curl Setup
bash
BASE="http://43.167.234.49:3101"
AUTH=(-H "X-API-Key: 123456" -H "Content-Type: application/json")bash
BASE="http://43.167.234.49:3101"
AUTH=(-H "X-API-Key: 123456" -H "Content-Type: application/json")代码格式规则
Code Format Rules
| 规则 | 值 |
|---|---|
| 参数名 | |
| 代码格式 | 纯数字,不带交易所后缀 |
| 单次上限 | 500 个代码 |
| 分隔符 | 英文逗号 |
| 市场 | 示例 |
|---|---|
| 上交所 (SH) | |
| 深交所 (SZ) | |
| 北交所 (BJ) | |
❌ 错误写法:、、
600519.SHSH600519sh600519| Rule | Value |
|---|---|
| Parameter Name | |
| Code Format | Pure numbers, without exchange suffix |
| Single Request Limit | 500 codes |
| Separator | English comma |
| Market | Example |
|---|---|
| Shanghai Stock Exchange (SH) | |
| Shenzhen Stock Exchange (SZ) | |
| Beijing Stock Exchange (BJ) | |
❌ Incorrect Format: , ,
600519.SHSH600519sh600519端点详情
Endpoint Details
GET /api/v2/cnstock/securities
GET /api/v2/cnstock/securities
批量查询 A股 实时报价。
| Parameter | Type | Required | Description |
|---|---|---|---|
| string | Yes | 证券代码,逗号分隔(如 |
| string | No | 返回字段,逗号分隔(不传返回全部) |
Batch query real-time A-share quotes.
| Parameter | Type | Required | Description |
|---|---|---|---|
| string | Yes | Securities codes, separated by commas (e.g., |
| string | No | Return fields, separated by commas (returns all if not provided) |
调用示例
Call Examples
bash
undefinedbash
undefined查询单只股票
Query single stock
curl -sS "${AUTH[@]}" "$BASE/api/v2/cnstock/securities?codes=600519"
curl -sS "${AUTH[@]}" "$BASE/api/v2/cnstock/securities?codes=600519"
批量查询
Batch query
curl -sS "${AUTH[@]}" "$BASE/api/v2/cnstock/securities?codes=600519,000001,300750"
curl -sS "${AUTH[@]}" "$BASE/api/v2/cnstock/securities?codes=600519,000001,300750"
只查指定字段
Query specified fields only
curl -sS "${AUTH[@]}" "$BASE/api/v2/cnstock/securities?codes=600519&fields=price,chgPct,volume"
curl -sS "${AUTH[@]}" "$BASE/api/v2/cnstock/securities?codes=600519&fields=price,chgPct,volume"
多股票并行查询
Parallel query for multiple stocks
curl -sS "${AUTH[@]}" "$BASE/api/v2/cnstock/securities?codes=600519" &
curl -sS "${AUTH[@]}" "$BASE/api/v2/cnstock/securities?codes=000001" &
wait
**响应示例**:
```json
{
"success": true,
"data": {
"600519": {
"name": "贵州茅台",
"price": 1688.50,
"chgPct": 1.25,
"volume": 3500000,
"high": 1695.00,
"low": 1675.00,
"open": 1680.00
}
},
"timestamp": 1710865200000
}curl -sS "${AUTH[@]}" "$BASE/api/v2/cnstock/securities?codes=600519" &
curl -sS "${AUTH[@]}" "$BASE/api/v2/cnstock/securities?codes=000001" &
wait
**Response Example**:
```json
{
"success": true,
"data": {
"600519": {
"name": "Kweichow Moutai",
"price": 1688.50,
"chgPct": 1.25,
"volume": 3500000,
"high": 1695.00,
"low": 1675.00,
"open": 1680.00
}
},
"timestamp": 1710865200000
}错误排查
Troubleshooting
| 错误 | 原因 | 修复 |
|---|---|---|
| 返回空数据 | | 用纯数字: |
| 400 | API key 无效 | 联系管理员检查 API Key |
| 部分代码无数据 | 代码不存在或已退市 | 核对代码是否正确 |
| Error | Cause | Fix |
|---|---|---|
| Empty data returned | | Use pure numbers: |
| 400 | Invalid API key | Contact administrator to check API Key |
| No data for some codes | Code does not exist or has been delisted | Verify if the code is correct |