go/docs/common-trade-calendar.md

交易日历接口文档

1. 接口说明

• 接口名称：交易日历
• 请求方式：GET
• 请求路径：/api/v1/common/trade-calendar
• 接口用途：获取上交所开市交易日列表，并返回当前数据中的最大交易日。

2. 请求参数

无

请求示例：

GET /api/v1/common/trade-calendar

3. 响应说明

字段名	类型	说明
open_dates	array[string]	全部开市日期列表，格式 YYYY-MM-DD
max_date	string	开市日期列表中的最大日期

4. 响应示例

{
  "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. 错误响应

服务端异常时：

{
  "error": "具体错误信息"
}