</>

交易日历交易所

从深交所官方交易日历返回指定日期范围内的开闭市信息。

接口类型: 临时请求（HTTP POST，查一次返回一次）
调用路径: /v1/request/stock_trade_calendar_exchange
接口名称: stock_trade_calendar_exchange
Provider: axdata.source.exchange
源: 交易所 / exchange
资产类型: stock
插件状态: enabled
信任级别: official
采集支持: 是，默认 stock_trade_calendar_exchange.snapshot

不传日期时默认返回当前自然年；传 year 返回全年；传 start_date/end_date 返回指定范围。

输入参数

参数	类型	必填	说明
`year`	string	否	年份，例如 2026；传 start_date/end_date 时优先按日期范围查询。
`start_date`	string	否	开始日期，格式 YYYYMMDD 或 YYYY-MM-DD。
`end_date`	string	否	结束日期，格式 YYYYMMDD 或 YYYY-MM-DD。

参数说明

日期优先级：start_date/end_date > year > 当前自然年。

参数示例

# 指定日期范围
client.call(
    "stock_trade_calendar_exchange",
    start_date="20260617",
    end_date="20260622",
)

# 指定年份
client.call("stock_trade_calendar_exchange", year=2026)

# 不传日期，默认当前自然年
client.call("stock_trade_calendar_exchange")

返回字段

字段	类型	说明
`cal_date`	date	自然日期，格式 YYYYMMDD。
`is_open`	boolean	是否交易日。
`pretrade_date`	date	上一个交易日；非交易日也返回最近上一交易日。
`next_trade_date`	date	下一个交易日；非交易日也返回最近下一交易日。

调用示例

Python SDK

import axdata as ax

client = ax.AxDataClient()
rows = client.call(
    "stock_trade_calendar_exchange",
    end_date='20260622',
    start_date='20260617',
)

HTTP API

POST /v1/request/stock_trade_calendar_exchange
Content-Type: application/json

{
  "params": {
    "start_date": "20260617",
    "end_date": "20260622"
  }
}

真实样例快照

展示插件接口目录里的固定 example.response，页面打开不会再次请求源端。

请求参数

{
  "start_date": "20260617",
  "end_date": "20260622"
}

响应样例

cal_date	is_open	pretrade_date	next_trade_date
20260617	True	20260616	20260618
20260618	True	20260617	20260622
20260619	False	20260618	20260622
20260622	True	20260618	20260623

生成时间：2026-07-06T16:54:55+00:00