free
交易日历(开市/休市 · 年末最后交易日)
A 股交易日历:逐个日期给出是否开市,以及该日是不是本周/本月/本季/本年的最后一个交易日(做结算日、到期日、调仓日的时候要用)。
和 /v1/calendar 的区别:那个是个股事件日历(分红/解禁/财报披露…),这个只讲市场开不开市。两个都要的话各调一次。
三种查询方式(三选一):
- 不传参数 → 当月整月
- date=2026-10-16 → 单日
- start+end → 任意区间;或 year=2026 → 整年
trading_only=true:只返回开市日(整年约 242 行,比 365 行更好用)。
⚠️ limit 默认已按查询范围自动补足(年/区间默认给满一年 400 行上限),不会截断;要翻页用 offset。
data 是排版好的表格;程序化读取用 structured(单表,[{列: 值}])。列为:日期 / 是否交易日 / 本周最后交易日 / 本季最后交易日 / 本年最后交易日 / 本月最后交易日。
⚠️ 本端点免费(不需要 API Key)。
get/v1/trade-calendar
Request
- Base URL: https://api.ashareapi.com (the document declares no server; this is the origin it was published from)
- URL: https://api.ashareapi.com/v1/trade-calendar
- Auth: none declared
Query parameters
datestring
单日 YYYY-MM-DD;留空则看 year/start+end,都空=当月
startstring
区间起始日 YYYY-MM-DD(与 end 配对)
endstring
区间结束日 YYYY-MM-DD(与 start 配对)
yearstring
整年,如 2026(与 date/start+end 三选一)
trading_onlyboolean
true=只返回开市日
limitinteger
返回行数上限(0=按范围自动:单日/当月不补,年/区间补满 400)
offsetinteger
跳过前 N 行(翻页用)
Response
Successful Response
unknown required
Changes
No recorded changes to this operation across all 2 revisions of this API.