跳到主要内容

交易日历

数据集标识：ref.trading_calendars；证券对象标识示例：000001.SZ

按交易日历逐日给出是否开市、休市原因、时段表类型与前后交易日，带可知时间：年度休市安排自交易所公告之时可知，临时休市以新行表达。中国内地证券市场 cn_securities 只取深交所月度交易日历，并与交易所年度休市安排公告逐日核对。

业务主键：calendar_id、trading_date、available_at，每行取值唯一。

接口​

用途方法与路径
查询数据POST /v1/datasets/ref.trading_calendars/query
契约与当前发布GET /v1/datasets/ref.trading_calendars
准备批量快照POST /v1/datasets/ref.trading_calendars/preparations

请求参数​

可在请求体 where 中作为 field 使用的筛选参数，名称保持契约原名。

参数名类型必填说明
calendar_idstring否交易日历标识，如 cn_securities。
start_datedate否查询开始日期，包含该日。
end_datedate否查询结束日期，包含该日。

返回字段​

列名保持契约原名，可直接用于 select、where 与结果行。

字段名中文名称类型可空说明
calendar_id交易日历string否交易日历标识，写作 <区域>_<名称>，如 cn_securities 中国内地证券市场（沪深北三所共用）。
trading_date日期date否日历所属地的自然日，包含休市日。
available_at可知时间timestamp否该行信息的公开时刻：年度休市安排取交易所公告的发布时刻（只有转载报道时取报道时刻，作为上界），临时休市取临时公告时刻。同一日期的更正以新行表达，旧行保留。
is_trading_day是否交易日boolean否该日是否开市。
session_profile时段表类型string是开市日选用的时段表类型登记值：regular 常规交易日，half_day 半日市，no_night_session 前一交易日不开夜盘；休市日为空。
day_reason日期类型string否regular 开市日，weekend 周末休市，public_holiday 法定节假日休市，exchange_holiday 交易所自定休市，unscheduled_closure 临时休市，early_close 提前收市，special_session 特别交易日。
previous_trading_date前一交易日date是该日之前最近的开市日；超出已构建范围时为空，不按惯例推算。
next_trading_date后一交易日date是该日之后最近的开市日；超出已构建范围时为空，不按惯例推算。
basis_document依据文件string否是否开市与休市原因的依据：交易所日历接口与年度休市安排公告。
evidence_sha256依据原件哈希string是休市安排公告原件内容的 sha256；尚未取得原件时为空。
verification_status核验状态string否verified 已有依据原件，unverified 尚未取得依据原件。

字段补充属性​

括号中是契约描述（GET /v1/datasets/{datasetId} 的 fields）里的键名。

字段名属性
day_reason枚举（allowedValues）：["regular", "weekend", "public_holiday", "exchange_holiday", "unscheduled_closure", "early_close", "special_session"]
verification_status枚举（allowedValues）：["verified", "unverified"]

请求示例​

向 https://api.<环境域名>/v1/datasets/ref.trading_calendars/query 发送 POST 请求（服务地址的替换方式见快速开始），请求头为 Authorization: Bearer <API_KEY> 与 Content-Type: application/json，请求体如下：

{
  "select": [
    "calendar_id",
    "trading_date",
    "is_trading_day",
    "day_reason",
    "previous_trading_date",
    "next_trading_date",
    "available_at"
  ],
  "where": [
    {
      "field": "calendar_id",
      "op": "eq",
      "value": "cn_securities"
    },
    {
      "field": "trading_date",
      "op": "gte",
      "value": "2026-10-01"
    },
    {
      "field": "trading_date",
      "op": "lte",
      "value": "2026-10-09"
    }
  ],
  "page": {
    "limit": 1000,
    "cursor": null
  }
}

响应示例​

实际结果随数据更新而变化；data 为空数组表示请求范围内没有可返回的记录。

{
  "datasetId": "ref.trading_calendars",
  "fields": [
    "calendar_id",
    "trading_date",
    "is_trading_day",
    "day_reason",
    "previous_trading_date",
    "next_trading_date",
    "available_at"
  ],
  "data": [
    {
      "available_at": "2025-12-22T09:02:00Z",
      "calendar_id": "cn_securities",
      "day_reason": "public_holiday",
      "is_trading_day": false,
      "next_trading_date": "2026-10-08",
      "previous_trading_date": "2026-09-30",
      "trading_date": "2026-10-01"
    },
    {
      "available_at": "2025-12-22T09:02:00Z",
      "calendar_id": "cn_securities",
      "day_reason": "regular",
      "is_trading_day": true,
      "next_trading_date": "2026-10-09",
      "previous_trading_date": "2026-09-30",
      "trading_date": "2026-10-08"
    }
  ],
  "page": {
    "nextCursor": null,
    "complete": true
  }
}