trading-calendar

查询中国内地(cn)或香港(hk)市场在指定闭区间内的交易日列表。用户提到「交易日历」「A 股交易日」「港股交易日」「某区间内的交易日」「trading calendar」时使用。返回裸 JSON 对象(market/start_date/end_date/trade_dates),不使用通用 code/message/data 信封。

SKILL.md

GitHub

查询交易日历

接口说明

项目 说明
接口名称 查询交易日历
外部接口 GET /api/v1/market/data/time/trading-calendar
请求方式 GET
适用场景 查询中国内地或香港市场在指定闭区间内的交易日列表

请求参数

参数名 类型 是否必填 描述 取值示例 备注
market string 是 市场 cn 仅支持 cn(中国内地)/ hk(香港)
start_date int 是 起始日期(含) 20251001 YYYYMMDD
end_date int 是 截止日期(含) 20251003 YYYYMMDD;须 >= start_date

请求区间的起止日期必须全部位于所选市场的日历覆盖范围内:

  • cn:2000-01-04 至 2026-12-31
  • hk:2010-01-04 至 2026-12-31

执行方式

# 查港股某区间交易日
python <RUN_PY> trading-calendar --market hk --start_date 20251001 --end_date 20251003
# 查 A 股某区间交易日
python <RUN_PY> trading-calendar --market cn --start_date 20260101 --end_date 20260131

<RUN_PY> 为主 SKILL.md 同级的 run.py 绝对路径。

响应结构

返回值为裸 JSON 对象,不使用通用的 code/message/data 响应信封。

{
  "market": "hk",
  "start_date": 20251001,
  "end_date": 20251003,
  "trade_dates": [20251002, 20251003]
}
字段 类型 说明
market string 请求的市场,cn 或 hk
start_date int 请求的起始日期,YYYYMMDD
end_date int 请求的截止日期,YYYYMMDD
trade_dates array<int> 日期闭区间内按升序排列的交易日

注意事项

  • market 仅支持 cn 和 hk,其他值返回 400。
  • start_date 不得晚于 end_date;区间须全部落在所选市场的日历覆盖范围内。
  • 响应直接是裸 JSON 对象,无 code/message 信封。