---
title: "交易日历（开市/休市 · 年末最后交易日）"
method: GET
path: "/v1/trade-calendar"
tags: ["free"]
---

# 交易日历（开市/休市 · 年末最后交易日）

`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

**A 股交易日历**：逐个日期给出是否开市，以及该日是不是本周/本月/本季/本年的**最后一个交易日**（做结算日、到期日、调仓日的时候要用）。

**和 `/v1/calendar` 的区别**：那个是**个股事件日历**（分红/解禁/财报披露…），这个**只讲市场开不开市**。两个都要的话各调一次。

**三种查询方式（三选一）**：
- 不传参数 → 当月整月
- `date=2026-10-16` → 单日
- `start`+`end` → 任意区间；或 `year=2026` → 整年

**`trading_only=true`**：只返回开市日（整年约 242 行，比 365 行更好用）。

⚠️ **`limit` 默认已按查询范围自动补足**（年/区间默认给满一年 400 行上限），不会截断；要翻页用 `offset`。

`data` 是排版好的表格；程序化读取用 **`structured`**（单表，`[{列: 值}]`）。列为：`日期` / `是否交易日` / `本周最后交易日` / `本季最后交易日` / `本年最后交易日` / `本月最后交易日`。

⚠️ 本端点**免费**（不需要 API Key）。

## Query parameters

- `date` string: 单日 YYYY-MM-DD；留空则看 year/start+end，都空=当月
- `start` string: 区间起始日 YYYY-MM-DD（与 end 配对）
- `end` string: 区间结束日 YYYY-MM-DD（与 start 配对）
- `year` string: 整年，如 2026（与 date/start+end 三选一）
- `trading_only` boolean: true=只返回开市日
- `limit` integer: 返回行数上限（0=按范围自动：单日/当月不补，年/区间补满 400）
- `offset` integer: 跳过前 N 行（翻页用）

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/ashareapi/apis/a-api.md) · [All operations](https://skmtc.dev/ashareapi/apis/a-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ashareapi/apis/a-api/revisions/fc57bdcb13d5?raw)