跳转至

trade_calendar — 交易日历

获取指数工作日历：每个日期是工作日还是非工作日，附节假日备注。

  • 接口：trade_calendar
  • 数据示例：见下文
  • 权限要求：scope calendar:read
  • 更新频率：随后台工作日历导入实时更新
  • 时效限制：无（不受行情延迟限制）

输入参数

名称 类型 必选 描述
trade_date str N 日期 YYYYMMDD（不能与 start_date/end_date 同用）
start_date str N 开始日期 YYYYMMDD（含边界）
end_date str N 结束日期 YYYYMMDD（含边界）

所有条件均可省略；省略时分页返回全部日历。

输出参数

名称 类型 描述
trade_date str 日期，YYYYMMDD
is_workday bool 是否为指数工作日（true / false）
remark str 节假日或特殊说明；未填写时为 ""

默认字段（省略 fields 时返回全部）：

1
["trade_date", "is_workday", "remark"]

接口使用

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
import tokease

pro = tokease.Client()

# 查询某月的日历
df = pro.query("trade_calendar", params={
    "start_date": "20260801",
    "end_date": "20260831",
})

# 查询单日是否工作日
df = pro.query("trade_calendar", params={"trade_date": "20260820"})

数据样例

trade_date is_workday remark
20260801 false 建军节
20260802 true
20260803 true
20260815 false 中元节
20260816 true

cURL 示例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
curl -X POST "https://your-domain/api/v1/query" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $WHALE_KEY" \
  -d '{
    "api_name": "trade_calendar",
    "params": {
      "start_date": "20260801",
      "end_date": "20260831"
    }
  }'

注意事项

  • 工作日历保存供 trade_calendar 查询，但当前指数计算以实际存在报价的日期为准，不会自动丢弃非工作日报价——即工作日历与行情日期是两套独立的数据。
  • 建议批量同步行情前先拉取日历，用工作日集合过滤预期交易日。

相关页面