节假日查询：证券交易休市怎么对齐？金融场景下的节假日应用
# 节假日查询：证券交易休市怎么对齐？金融场景下的节假日应用
> 接口 894（894-6 单日判定） · 免费 · POST/GET · 返回 JSON · 适用人群：证券/量化从业者 · 阅读时间：约 7 分钟
## TL;DR
- 文档点名节假日查询适用于"证券投资"场景——用它判定**法定节假日的休市日**很合适。
- 用 894-6 的 `type`：`3`=节假日即休市，`1`=工作日即正常交易日（周末另算）。
- **边界必须说清**：本接口只覆盖法定节假日，不含交易所临时休市/特殊安排，落地要以交易所公告为准。
## Why：交易日历是量化与运营的基础
券商 App 要标注休市、量化策略要跳过非交易日回测、基金运营要算 T+1 起息——这些都依赖一份可靠的"交易日历"。节假日查询提供官方自营的法定节假日数据，是构建交易日历的低成本起点。
## What：能做什么、不能做什么
| 能 | 不能 |
|----|------|
| 判定某天是否为法定节假日（休市） | 不含上交所/深交所的临时休市公告 |
| 判定工作日/周末 | 不含港股通、北向资金等特殊安排 |
| 提供全年放假 + 调休 | 不含期货/期权各自的特殊交易日 |
> 结论：本接口适合做**法定节假日维度**的休市对齐；交易所级特殊安排请以官方公告为准，接口数据不可替代。
## How：用 894-6 判定交易日
```python
import requests
def is_trading_day(day: str, appkey: str) -> bool:
r = requests.post("https://route.showapi.com/894-6",
params={"appKey": appkey, "day": day}, timeout=10)
b = r.json()["showapi_res_body"]
if str(b["ret_code"]) != "0":
raise RuntimeError(b.get("showapi_res_error"))
# type: 1=工作日 2=周末 3=节假日
return b["type"] == "1"
# 例：2026-01-01 元旦 → False（休市）
print(is_trading_day("2026-01-01", "YOUR_APPKEY"))
```
**注意周末**：`type=2`（周末）同样非交易日，判定时 `type == "1"` 才视为交易日即可自然排除。
## 返回示例与解析
```json
{
"showapi_res_body": {
"ret_code": 0,
"day": "2026-01-01",
"type": "3",
"holiday": "元旦"
}
}
```
`type=3` → 法定节假日 → 休市。字段细节见 [返回字段全解](https://www.showapi.com/guides/holiday-query-response-codes-894)。
## 进阶 / 边界
- **只覆盖法定节假日**：调休补班日（894-7）是"上班日"，但证券市场是否交易仍以交易所安排为准，不要直接把补班日当交易日。
- **数据自 2018 年起**：历史回测如需更早数据，维护本地交易日历。
- **次年窗口**：10–11 月前次年法定节假日可能未全，策略上线前确认数据已更新。
- **不要过度承诺**：对外展示"休市"时标注"以交易所公告为准"，避免合规风险。
## FAQ
**Q1：能用它直接生成 A 股交易日历吗？**
A：可作为法定节假日维度的基准，但交易所临时休市/特殊安排需另行叠加官方公告。
**Q2：补班日（调休上班）算交易日吗？**
A：本接口只判定法定属性；证券市场是否交易以交易所公告为准，切勿直接等同。
**Q3：周末怎么处理？**
A：`type=2` 即周末，非交易日；`type=="1"` 才视为交易日，自然排除周末与节假日。
**Q4：数据准吗？**
A：官方自营、随国务院文件每年更新；交易所级特殊安排不在覆盖范围内。
**Q5：ret_code 类型？**
A：894-6 是数字 `0`，判断统一用 `str(...)`。
## 相关能力 / 下一步阅读
- [节假日查询：某天到底放不放假？894-6 单日判定接入指南](https://www.showapi.com/guides/holiday-query-day-check-894)
- [节假日查询：为什么只能查 2018 年起？数据覆盖范围与边界说明](https://www.showapi.com/guides/holiday-query-data-range-894)
- [节假日查询：免费接口也要省调用，节假日数据缓存策略设计](https://www.showapi.com/guides/holiday-query-cache-894)
- **本系列共 12 篇**：查看[节假日查询指南总目录](https://www.showapi.com/guides/holiday-query-guides-894)
