交易日历

公开接口

实时行情 Tick · 查询交易日历

查询指定市场的交易日列表，按日期升序返回 ISO 日期字符串数组。数据由采集端经「上传交易日历」接口落库（trading_calendar 表），覆盖 A 股（cn）与港股（hk）。可用 start_date / end_date 限定区间，或用 year 直接取某一年的全部交易日。

接口地址

GET /cn/tick/trading_calendar

完整地址：https://api.databull.cn/cn/tick/trading_calendar

接口说明

查询指定市场的交易日列表，按日期升序返回 ISO 日期字符串数组。

可选 start_date / end_date（YYYYMMDD 或 YYYY-MM-DD）限定区间，或用 year 直接取某一年的全部交易日；区间为空时返回该市场全部已入库交易日。

无数据时返回空数组 []；因为响应体固定是数组，无法在体内附带原因，空结果会在响应头 X-Empty-Reason 给出：calendar_not_loaded（该市场从未上传过交易日历）或 no_match（有数据但区间没命中）。

请求参数

参数位置类型必填默认说明

market查询string否cn市场标识：cn / hk

start_date查询string否起始日期（含），YYYYMMDD 或 YYYY-MM-DD；留空不限制

end_date查询string否结束日期（含），YYYYMMDD 或 YYYY-MM-DD；留空不限制

year查询integer否—按年份筛选（如 2026），优先级低于显式区间；留空不限制

返回字段

字段类型说明

（数组元素）string交易日，ISO 格式 YYYY-MM-DD，按升序排列

接口示例

cURL

curl "https://api.databull.cn/cn/tick/trading_calendar?market=cn&start_date=20260101" \
  -H "Authorization: Bearer $DATABULL_API_KEY"

Python

from databull import DataBull

client = DataBull(api_key="YOUR_API_KEY")
result = client.get_trading_calendar(market="cn", year=2026)
print(result)

响应示例

JSON

[
  "2026-01-02",
  "2026-01-05",
  "2026-01-06",
  "2026-01-07"
]

错误码

状态码触发条件

401缺少或无效 API 凭证

说明

需携带 API 凭证（Authorization: Bearer <Key> 或 X-API-Key）。
start_date / end_date 同时接受 YYYYMMDD 与 YYYY-MM-DD，均含当天。
start_date / end_date 与 year 同时传时，以显式区间优先。
区间为空时返回该市场全部已入库交易日；无数据返回空数组 []。
因为响应体固定是数组，空结果无法在体内附带原因，改由响应头 X-Empty-Reason 给出：calendar_not_loaded（该市场从未上传过日历）或 no_match（有数据但筛选没命中）。