跳到主要内容

交易日历

交易日历模块，提供 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 自然日），无任何请求参数。

请求参数​

参数位置类型必需说明默认值
----无入参。-

请求示例​

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

响应示例​

{
  "code": 0,
  "message": "success",
  "request_id": "a1b2c3d4e5f6789012345678abcdef01",
  "data": {
    "timestamp": 1748102400000,
    "item": [
      { "date_ms": 1716566400000, "date": "20250525" },
      { "date_ms": 1716652800000, "date": "20250526" },
      { "date_ms": 1716739200000, "date": "20250527" }
    ]
  }
}

响应字段​

data 为 TradingDaysData：

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

item[] 为 TradingDayItem：

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