实时行情
股票、ETF、交易所指数、申万指数与期货分开请求。返回统一采用 data.fields + data.items,并在 data.meta 中给出数据时间与缓存状态。
股票实时日线
POSThttps://jinniu.ziyoutang.com/api/rt_k
请求参数
| 参数 | 必填 | 说明 |
| ts_code | 是 | 一个或多个股票代码,逗号分隔,单次最多 100 个。 |
| fields | 否 | 可选字段:ts_code,name,pre_close,high,open,low,close,vol,amount,num。 |
请求示例
curl -X POST 'https://jinniu.ziyoutang.com/api/rt_k' \
-H 'Content-Type: application/json' \
-H 'X-Api-Key: YOUR_API_KEY' \
-d '{"ts_code":"000001.SZ"}'
返回参数
| 字段 | 类型 | 说明 |
| success / message | boolean / string | 请求是否成功、响应消息;无计量单位。 |
| data.fields / data.items | array / array | 返回列名及数据行;每行按 fields 顺序排列。 |
| ts_code / name | string | 股票代码、证券名称;文本字段,无计量单位。 |
| pre_close | number | 上一交易日收盘价,单位:元/股。 |
| open / high / low / close | number | 当日开盘、最高、最低与最新价,单位:元/股。 |
| vol | number | 成交量,单位:股。 |
| amount | number | 成交额,单位:元人民币。 |
| num | number | 成交笔数,单位:笔。 |
| data.meta | object | 缓存状态和数据时间,字段说明见本节末尾。 |
返回示例
{"success":true,"message":"","data":{"fields":["ts_code","name","pre_close","high","open","low","close","vol","amount","num"],"items":[["000001.SZ","平安银行",12.28,12.48,12.31,12.2,12.42,1234567,152340000,8654]],"meta":{"cached":false,"stale":false,"cache_ttl_seconds":0,"cache_age_seconds":0,"server_received_at":"2026-09-07 10:30:02","max_age_seconds":null}}}
实时返回元数据
| 字段 | 说明 |
| cached | 是否命中服务器缓存;实时分钟线可能为 true,实时日线固定为 false。 |
| stale | 是否在行情服务临时失败时返回短时缓存;实时日线不使用缓存,固定为 false。 |
| cache_ttl_seconds | 缓存有效期,单位:秒;实时分钟线为 2 秒,实时日线为 0 秒。 |
| cache_age_seconds | 当前缓存已存在的时长,单位:秒;实时日线固定为 0。 |
| server_received_at | 服务器接收到行情数据的北京时间;时间字段,无计量单位。 |
| max_age_seconds | 返回 K 线中最旧数据距服务器当前时间的最大时长,单位:秒;无法计算时为 null。 |