57 lines
1021 B
Markdown
57 lines
1021 B
Markdown
# 交易日历接口文档
|
|
|
|
## 1. 接口说明
|
|
|
|
- 接口名称：交易日历
|
|
- 请求方式：`GET`
|
|
- 请求路径：`/api/v1/common/trade-calendar`
|
|
- 接口用途：获取上交所开市交易日列表，并返回当前数据中的最大交易日。
|
|
|
|
## 2. 请求参数
|
|
|
|
无
|
|
|
|
请求示例：
|
|
|
|
```http
|
|
GET /api/v1/common/trade-calendar
|
|
```
|
|
|
|
## 3. 响应说明
|
|
|
|
| 字段名 | 类型 | 说明 |
|
|
| --- | --- | --- |
|
|
| `open_dates` | `array[string]` | 全部开市日期列表，格式 `YYYY-MM-DD` |
|
|
| `max_date` | `string` | 开市日期列表中的最大日期 |
|
|
|
|
## 4. 响应示例
|
|
|
|
```json
|
|
{
|
|
"open_dates": [
|
|
"2026-04-20",
|
|
"2026-04-21",
|
|
"2026-04-22",
|
|
"2026-04-23",
|
|
"2026-04-24"
|
|
],
|
|
"max_date": "2026-04-24"
|
|
}
|
|
```
|
|
|
|
## 5. 业务规则
|
|
|
|
- 只返回 `trade_calendar` 表中 `exchange = 'SSE'` 且 `is_open = 1` 的交易日。
|
|
- 日期按升序返回。
|
|
- `max_date` 等于列表中的最后一个日期。
|
|
|
|
## 6. 错误响应
|
|
|
|
服务端异常时：
|
|
|
|
```json
|
|
{
|
|
"error": "具体错误信息"
|
|
}
|
|
```
|