跳到主要内容

交易日历

交易日历模块，提供 A 股交易日序列与指定区间查询。 返回统一响应信封 ApiResponse，业务错误经 code 字段表达，HTTP 状态码恒为 200。

通用约定
  • Base URL：https://fuyao.aicubes.cn。
  • 必需请求头：X-api-key，缺失或无效返回 code=2001。
  • 信封 data.timestamp 为毫秒级 Unix 时间戳；item 内同时返回毫秒戳 date_ms 与可读日期 date（yyyyMMdd），时区按 Asia/Shanghai。
GET /api/a-share/calendar/trading-days

MCP Tool：get_a_share_calendar_trading_days

查询指定闭区间的 A 股交易日，单次最多十个自然年。起止日期均省略时，查询 [今日 - 1 年, 今日]（Asia/Shanghai 自然日）。

请求参数​

参数位置类型必需说明默认值
start_datequerystring否开始日期，yyyyMMdd，包含当天；与 end_date 成对提供。两者省略时取今日减一年
end_datequerystring否结束日期，yyyyMMdd，包含当天；最多十个自然年。两者省略时取今日

请求示例​

curl 'https://fuyao.aicubes.cn/api/a-share/calendar/trading-days' \
  -H 'X-api-key: <your-api-key>'

自定义区间示例：

curl 'https://fuyao.aicubes.cn/api/a-share/calendar/trading-days?start_date=20161027&end_date=20261027' \
  -H 'X-api-key: <your-api-key>'

范围与错误​

  • 起止日期必须成对提供；显式空值、格式错误或不存在的日期返回 code=1002。
  • 开始日期晚于结束日期，或结束日期超过开始日期加十个自然年，返回 code=1003。
  • 允许恰好十年和同日查询；同日休市返回空列表。20200229 的十年上限为 20300228。
  • 日期覆盖与可用性以实际返回为准。

响应示例​

{
  "code": 0,
  "message": "success",
  "request_id": "a1b2c3d4e5f6789012345678abcdef01",
  "data": {
    "timestamp": 1748275200000,
    "item": [
      {
        "date_ms": 1747929600000,
        "date": "20250523"
      },
      {
        "date_ms": 1748188800000,
        "date": "20250526"
      },
      {
        "date_ms": 1748275200000,
        "date": "20250527"
      }
    ]
  }
}

响应字段​

data 为 TradingDaysData：

字段类型说明
timestamplong数据就绪时间（毫秒）。
itemarray交易日列表，按时间升序。

item[] 为 TradingDayItem：

字段类型说明
date_mslong单个交易日的 Asia/Shanghai 00:00:00 毫秒戳。
datestring同一交易日的 yyyyMMdd 格式（Asia/Shanghai），方便直接展示 / 对账。