Holidays By Exchange交易所休市日查询
该接口按证券交易所代码返回法定休市日、节假日名称及是否提前半日收盘等非交易日安排。它是量化交易调度器、跨市场行情采集管道与回测日历对齐模块判断市场开闭市状态的核心参考源。
https://quote-fmp.com/stable/holidays-by-exchange?exchange=NASDAQ数据更新周期
N/A · 不适用固定周期
接口说明
- 法定休市与节假日清单查询：按交易所代码（如
NYSE、NASDAQ、HKSE）返回历年法定节假日名称、休市日期及开闭市状态（isClosed），帮助交易系统在盘前调度时精准跳过非交易日。 - 半日市与时段识别：除全天闭市外，美股等市场在感恩节次日、平安夜前夕存在提前收盘的半日交易安排。接口明确标注每日精确开盘与提前闭市时刻，防止日内策略在流动性骤降的尾盘窗口误触发指令。
- 历史回测交易日历对齐：在构建多市场日频或分钟频回测框架时，结合该接口剔除法定节假日，可准确区分「交易所正常休市」与「数据源缺失断档」，保障收益率序列与波动率年化计算的准确性。
- 跨模块关联接口：Available Exchanges（可用交易所清单） · Earnings Calendar（财报日历） · Economic Data Releases Calendar（经济数据日历） · Exchange Stock Quotes（交易所全量报价）
请求参数
3 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
exchange | string | 必填 | NASDAQ | 目标交易所代码或名称，如 NASDAQ、NYSE、AMEX。 |
from | date | 可选 | 2025-04-27 | 查询起始日期，格式 YYYY-MM-DD，包含当天。 |
to | date | 可选 | 2026-04-27 | 查询结束日期，格式 YYYY-MM-DD，包含当天。 |
调用代码示例
Python 关键代码通过 /stable/holidays-by-exchange 检索交易所休市日查询（参数：必填 exchange），输出 exchange（交易所代码）、name（名称）、isClosed（是否已关闭）（示例 exchange=NASDAQ）。
resp = requests.get(
"https://quote-fmp.com/stable/holidays-by-exchange",
params={"exchange": "NASDAQ", "from": "2025-04-27", "to": "2026-04-27", "apikey": FMP_KEY},
timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 提取 交易所休市日查询 核心列：exchange, date, name, isClosed
df = df[["exchange", "date", "name", "isClosed"]].dropna(how="all")参数使用和避坑
2 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法：
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 指定 2025 年初三个月窗口拉取交易所休市日查询 | exchange=NASDAQ&from=2025-01-01&to=2025-03-31 | 在 /stable/holidays-by-exchange 中传入季度起止日期，避免单次跨度过大并提取 exchange、name、isClosed 共 6 项指标。 |
| 历史滑窗（2024-07 至 2024-12）采集交易所休市日查询 | exchange=NASDAQ&from=2024-07-01&to=2024-12-31 | 限定 2024-07-01 到 2024-12-31 调用 /stable/holidays-by-exchange，提取历史归档所需的 exchange、name、isClosed 共 6 项属性。 |
/stable/holidays-by-exchange（必填 exchange）返回的 exchange（交易所代码，样本 NASDAQ）为当前有效记录；在写入本地维表或缓存前，请先去除首尾空白字符并校验非空。
交易所休市日查询返回的 exchange（交易所代码，示例 NASDAQ）在增量同步时，应按 (date, exchange, name) 覆盖更新已有记录，保证本地维表幂等。
返回数据
6 个字段本接口示例响应共包含 6 个字段（数值型 0 个，文本/日期/布尔型 6 个）。下表列出全部字段名、类型、首条记录真实样本值与中文释义，实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
exchange | string | "NASDAQ" | 交易所代码 |
date | string | "2026-07-03" | 日期 |
name | string | "Independence Day" | 名称 |
isClosed | boolean | true | 是否已关闭 |
adjOpenTime | null | null | 复权开盘时间 |
adjCloseTime | null | null | 复权收盘时间 |
查看响应数据示例（原始 JSON）
[
{
"exchange": "NASDAQ",
"date": "2026-07-03",
"name": "Independence Day",
"isClosed": true,
"adjOpenTime": null,
"adjCloseTime": null
}
]常见问题解答（FAQ）
2 个问题自动化采集中如何搭配调用交易所休市日查询（/stable/holidays-by-exchange）与同模块的 全球交易所交易时段？
在「Market Hours」模块内，交易所休市日查询（/stable/holidays-by-exchange，必填 exchange）负责输出 exchange 与 name 等 6 项指标，Global Exchange Market Hours（全球交易所交易时段）负责输出 6 项指标。
调用 /stable/holidays-by-exchange 采集交易所休市日查询时，如何设计参数控制与批量请求策略？
工程上推荐将 [from, to] 拆分为季度或年度滑窗访问 /stable/holidays-by-exchange；同时复用 requests.Session() 保持 HTTP Keep-Alive，直接提取 exchange 与 name。
同模块相关接口对比
Market Hours本接口路径 /stable/holidays-by-exchange，必填参数 exchange。 同一模块「Market Hours」下共 3 个接口，下表列出其余 2 个， 按粒度与查询维度对比，避免选错接口。