MarketHours（交易时间）

Q: exchange 参数支持哪些交易所代码？

可先调用 All Exchange Market Hours（交易所交易时段） 或 directory 类别下的 Available Exchanges（可用交易所清单） 查看全部支持的交易所短码（如 NASDAQ、NYSE、HKSE、SHH、SZSE、LSE 等）。

Q: 感恩节次日、平安夜这类美股提前收盘（半日市）能查到吗？

可以。调用 Holidays By Exchange（交易所休市日查询） 接口，返回记录里会区分全天休市（isFullyClosed）与提前收市的具体时间（adjCloseTime）。

此类接口提供全球各交易所的交易时间信息，包括开盘收盘时间、节假日安排，可按交易所单独查询或一次取回全部。做跨时区调度、定时任务、行情数据对齐时很实用，能避免在休市日发起无意义的批量请求；夏令时切换带来的时间偏移，以接口返回的当地时间为准。

典型使用场景

4 个场景

行情采集调度网关

仅在目标交易所开市窗口内唤醒高频轮询任务，节省请求配额。

终端开闭市状态灯

在行情页面顶部展示美股、港股、A 股、欧股当前是否交易中及距离开盘/收盘倒计时。

回测交易日历生成

结合节假日清单剔除非交易日，准确计算持仓交易天数。

跨市场实盘风控守卫

在收盘前或半日市提前收盘窗口触发自动平仓与挂单撤销逻辑。

接口怎么选？

3 项选型对照

交易时间类别用于给自动化采集、量化交易调度器和行情终端提供「此刻市场开没开门、哪天休市」的权威判断，避免在休市日空跑轮询或把停盘数据误判为行情源故障。

支持查询单个交易所的详细时段（含午间休市）、全交易所一览表，以及指定交易所的节假日休市日历。

你的需求	推荐接口	选择理由
查询单个交易所的开闭市时间与当前状态	Global Exchange Market Hours全球交易所交易时段	按 exchange 代码（如 NASDAQ、HKSE）精准查询
一次获取全球所有支持交易所的交易时段与开市状态	All Exchange Market Hours交易所交易时段	适合多市场调度器一次拉全表缓存在本地
查询指定交易所的节假日与提前收市日期	Holidays By Exchange交易所休市日查询	提前编排全年交易日历与定时任务开关

数据覆盖与参数口径

核心字段：exchange、openingHour、closingHour、timezone、isMarketOpen
时区说明：返回的时间对应交易所当地 timezone，跨市场调度需注意夏令时（DST）切换
特殊交易日：Holidays By Exchange（交易所休市日查询）包含全天休市（isClosed）与半日市提前收盘时间（adjCloseTime）
核心返回字段：exchange、name、openingHour、closingHour、timezone、isMarketOpen；节假日含 date、name、isClosed、adjCloseTime
缓存与更新策略：节假日表按 (exchange, date) 每日同步一次；开闭市状态可在交易时段边缘按分钟刷新

调用示例

Python 关键代码

示例场景：查询纳斯达克（NASDAQ）当前开市状态与节假日 · 对应接口：Global Exchange Market Hours（全球交易所交易时段）

Python（核心参数与字段清洗逻辑）

resp = requests.get(
    "https://quote-fmp.com/stable/exchange-market-hours",
    params={"exchange": "NASDAQ", "timestamp": "1769527402", "apikey": FMP_KEY},
    timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 提取 全球交易所交易时段 核心列：exchange, name, openingHour, closingHour
df = df[["exchange", "name", "openingHour", "closingHour"]].dropna(how="all")

定时任务启动前先查 isMarketOpen 或本地缓存的 Holidays By Exchange（交易所休市日查询），非交易时段自动挂起。
注意欧美市场冬令时/夏令时切换会导致对应的北京时间平移 1 小时。

数据注意事项

4 条实盘要点

Global Exchange Market Hours（全球交易所交易时段）与 All Exchange Market Hours（交易所交易时段）返回的 openingHour 与 closingHour 均为交易所当地时区（timezone），跨市场调度需处理欧美冬/夏令时（DST）1 小时偏移。
感恩节次日、平安夜等美股半日市并非全天休市，需读取 Holidays By Exchange（交易所休市日查询）中的 isFullyClosed 与提前收盘时间 adjCloseTime 字段。
部分亚洲市场（如港交所 HKSE、上交所 SHH、深交所 SZSE、东证 JPX）存在午间休市时段，定时采集器应识别午休窗口避免无效轮询。
建议每日开盘前调用一次 All Exchange Market Hours（交易所交易时段）与 Holidays By Exchange（交易所休市日查询）缓存至本地内存或 Redis，供全站行情任务统一读取开闭市状态。