# 交易日历

上交所（SSE）与深交所（SZSE）的交易日历，标记每个自然日是否为交易日并给出对应的上一交易日（pretrade_date）。适用于回测日期对齐、计算滚动窗口、补齐缺失交易日及判断节假日休市。两个交易所分别返回，绝大多数交易日一致但需按 exchange 区分查询。注意日历会随官方放假安排发布而更新，跨年回测前应确认覆盖到目标年份。

`GET /v2/reference/trade-calendar`

## 请求参数

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `exchange` | string | 否 | 交易所：SSE 上交所 / SZSE 深交所（默认 SSE） |
| `is_open` | int | 否 | 是否交易日：1 交易 / 0 休市 |
| `start_date` | string | 否 | 开始日期 (YYYYMMDD) |
| `end_date` | string | 否 | 结束日期 (YYYYMMDD) |

## 返回字段

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `exchange` | string | 交易所代码（SSE / SZSE） |
| `cal_date` | string | 日历日期 |
| `is_open` | int | 1=交易日, 0=休市 |
| `pretrade_date` | string | 上一个交易日 |

## 接口示例

cURL

```
curl -H "X-API-Key: YOUR_KEY" \
  "https://asharehub.com/v2/reference/trade-calendar?exchange=SSE"
```

Python SDK

```
from asharehub import AShareHub

client = AShareHub(api_key="YOUR_KEY")
df = client.trade_calendar(exchange="SSE")
print(df.head())
```

## 数据样例

返回 pandas.DataFrame

| exchange | cal_date | is_open | pretrade_date |
| --- | --- | --- | --- |
| SSE | 20261231 | 1 | 20261230 |
| SSE | 20261230 | 1 | 20261229 |
| SSE | 20261229 | 1 | 20261228 |