跳到主要内容

股票交易日历

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

股票市场交易日、休市日和前一交易日。

接口​

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

请求参数​

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

参数名类型必填说明
marketstring否市场代码；中文客户端默认 CN。
start_datedate否查询开始日期，包含该日。
end_datedate否查询结束日期，包含该日。

返回字段​

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

字段名中文名称类型可空说明
market市场string否日历所属市场代码，例如 CN、HK 或 US。
exchange交易所string是日历对应的交易所代码；市场级联合日历可以为空。
calendar_date日历日期date否按市场本地时区确定的自然日期。
is_trading_day是否交易日boolean否该市场或交易所在此日期是否安排常规交易。
previous_trading_date前一交易日date是严格早于当前日期的最近交易日。

请求示例​

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

{
  "select": [
    "market",
    "exchange",
    "calendar_date",
    "is_trading_day",
    "previous_trading_date"
  ],
  "where": [
    {
      "field": "market",
      "op": "eq",
      "value": "CN"
    },
    {
      "field": "calendar_date",
      "op": "gte",
      "value": "2026-01-01"
    },
    {
      "field": "calendar_date",
      "op": "lte",
      "value": "2026-01-01"
    }
  ],
  "page": {
    "limit": 1000,
    "cursor": null
  }
}

响应示例​

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

{
  "datasetId": "stock.trading_calendar",
  "fields": [
    "market",
    "exchange",
    "calendar_date",
    "is_trading_day",
    "previous_trading_date"
  ],
  "data": [
    {
      "calendar_date": "2026-01-01",
      "exchange": "SH",
      "is_trading_day": false,
      "market": "CN",
      "previous_trading_date": "2025-12-31"
    },
    {
      "calendar_date": "2026-01-01",
      "exchange": "SZ",
      "is_trading_day": false,
      "market": "CN",
      "previous_trading_date": "2025-12-31"
    }
  ],
  "page": {
    "nextCursor": null,
    "complete": true
  }
}