86 lines
1.5 KiB
Markdown
86 lines
1.5 KiB
Markdown
# 股票历史 K 线接口文档
|
|
|
|
## 1. 接口说明
|
|
|
|
- 接口名称：股票历史 K 线
|
|
- 请求方式：`GET`
|
|
- 请求路径：`/api/v1/stock/kline/:code`
|
|
- 接口用途：获取指定股票自 `2024-09-24` 起的历史日线数据。
|
|
|
|
## 2. 请求参数
|
|
|
|
路径参数：
|
|
|
|
| 参数名 | 类型 | 必填 | 示例 | 说明 |
|
|
| --- | --- | --- | --- | --- |
|
|
| `code` | `string` | 是 | `000001.SZ` | TS 股票代码 |
|
|
|
|
请求示例：
|
|
|
|
```http
|
|
GET /api/v1/stock/kline/000001.SZ
|
|
```
|
|
|
|
## 3. 响应说明
|
|
|
|
返回值为数组，每个元素代表一个交易日的 K 线数据。
|
|
|
|
| 字段名 | 类型 | 说明 |
|
|
| --- | --- | --- |
|
|
| `ts_code` | `string` | TS 股票代码 |
|
|
| `trade_date` | `string` | 交易日时间 |
|
|
| `open` | `number` | 开盘价 |
|
|
| `high` | `number` | 最高价 |
|
|
| `low` | `number` | 最低价 |
|
|
| `close` | `number` | 收盘价 |
|
|
| `pct_chg` | `number` | 涨跌幅 |
|
|
| `vol` | `number` | 成交量 |
|
|
|
|
## 4. 响应示例
|
|
|
|
```json
|
|
[
|
|
{
|
|
"ts_code": "000001.SZ",
|
|
"trade_date": "2026-04-21T00:00:00+08:00",
|
|
"open": 10.01,
|
|
"high": 10.55,
|
|
"low": 9.98,
|
|
"close": 10.43,
|
|
"pct_chg": 3.24,
|
|
"vol": 1234567
|
|
}
|
|
]
|
|
```
|
|
|
|
## 5. 业务规则
|
|
|
|
- 查询起始日期固定为 `2024-09-24`。
|
|
- 返回结果按 `trade_date` 升序排序。
|
|
|
|
## 6. 空数据说明
|
|
|
|
若指定股票无数据，返回空数组：
|
|
|
|
```json
|
|
[]
|
|
```
|
|
|
|
## 7. 错误响应
|
|
|
|
当路径参数为空时：
|
|
|
|
```json
|
|
{
|
|
"error": "股票代码不能为空"
|
|
}
|
|
```
|
|
|
|
当服务端内部异常时：
|
|
|
|
```json
|
|
{
|
|
"error": "具体错误信息"
|
|
}
|
|
```
|