Economic Data Releases Calendar经济数据日历
该接口按自定义起止日期区间返回全球主要经济体即将发布或已发布的宏观经济数据日历流水。每条记录详列具体发布时间戳、国家与货币代码、经济事件名称、官方影响重要度分级，以及前值、市场一致预期值、实际公布值与变动幅度，是宏观事件交易与跨市场风控的核心日历。
https://quote-fmp.com/stable/economic-calendar数据更新周期
5 Minutes
接口说明
- 宏观重磅数据发布日历与盘中风控避险：外汇、黄金、美债及美股股指期货在重磅经济数据公布瞬间常伴随剧烈的流动性抽干与点差扩大。量化交易系统可每日预拉取该经济日历，按影响重要度（High Impact）与国家过滤，在数据公布前后数分钟自动暂停高频做市或收紧风险敞口。
- 捕捉宏观数据预期差（Surprise）量化交易信号：接口在同一条记录中并列提供前期历史值（前值）、发布前的彭博／路透市场一致预期值以及落地瞬间的实际公布值。通过计算“（实际值－预期值）／预期值”构建标准化宏观预期差指标，可第一时间驱动利率、汇率与股指期货的脉冲动量策略。
- 覆盖全球多经济体的全天候宏观监控排期：除美国核心数据外，日历还同步收录欧元区、英国、日本、中国、加拿大及澳洲等主要经济体的央行利率决议、PMI、通胀与贸易账日程，满足全球宏观对冲策略全天候 24 小时的跨时区事件监控需求。
- 上下游关联接口：Forex Quote（外汇实时报价） · COT Report（COT 持仓报告） · Market Sector Performance Snapshot（板块表现快照） · S&P 500 Index（标普500成分股）
请求参数
3 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
country | string | 可选 | US | 公司注册或上市国家，用于按地域筛选。 |
from | date | 可选 | 2026-01-27 | 查询起始日期，格式 YYYY-MM-DD，包含当天。 |
to | date | 可选 | 2026-04-27 | 查询结束日期，格式 YYYY-MM-DD，包含当天。 |
调用代码示例
Python 关键代码从 /stable/economic-calendar 同步经济数据日历（可选 country, from），一次拿齐 country（国家/地区）、event（事件名称）、previous（上一期数值）（样本值 country=SG）。
resp = requests.get(
"https://quote-fmp.com/stable/economic-calendar",
params={"country": "US", "from": "2026-01-27", "to": "2026-04-27", "apikey": FMP_KEY},
timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 按 date 升序重排并数值化 previous（上一期数值）
df["previous"] = pd.to_numeric(df["previous"], errors="coerce")
df = df.sort_values("date").reset_index(drop=True)参数使用和避坑
2 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法：
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 按季度日历边界检索 2025Q1 经济数据日历 | from=2025-01-01&to=2025-03-31 | 以闭区间 [2025-01-01, 2025-03-31] 查询 /stable/economic-calendar，精准过滤出当季的 country、event、previous 明细。 |
| 指定 2024 年末半年窗口同步经济数据日历 | from=2024-07-01&to=2024-12-31 | 切换至 2024 年下半年区间查询 /stable/economic-calendar，与当期数据拼接成连续的 country、event、previous 时间序列。 |
针对 /stable/economic-calendar（经济数据日历，可选 country, from），返回首行的 country 为 SG、event 为 Import Prices YoY (Jun)；入库前请先拦截 200 [] 空响应。
持久化 /stable/economic-calendar（经济数据日历）的 11 个字段时，自然键取 (date, country, event)；数值列 previous（样本 18.5）切勿用整型截断小数精度。
返回数据
11 个字段本接口示例响应共包含 11 个字段（数值型 5 个，文本/日期/布尔型 6 个）。下表列出全部字段名、类型、首条记录真实样本值与中文释义，实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
date | string | "2026-07-29 03:30:00" | 日期 |
country | string | "SG" | 国家/地区 |
event | string | "Import Prices YoY (Jun)" | 事件名称 |
currency | string | "SGD" | 计价币种 |
previous | number | 18.5 | 上一期数值 |
estimate | number | 21 | 分析师预期值 |
actual | number | 13.6 | 实际值 |
change | number | -4.9 | 涨跌额 |
impact | string | "Low" | 影响 |
changePercentage | number | -26.486 | 涨跌幅（%） |
unit | string | "%" | 单位 |
查看响应数据示例（原始 JSON）
[
{
"date": "2026-07-29 03:30:00",
"country": "SG",
"event": "Import Prices YoY (Jun)",
"currency": "SGD",
"previous": 18.5,
"estimate": 21,
"actual": 13.6,
"change": -4.9,
"impact": "Low",
"changePercentage": -26.486,
"unit": "%"
}
]常见问题解答（FAQ）
2 个问题在「Economics Data」下，经济数据日历（/stable/economic-calendar）与 美国国债收益率（/stable/treasury-rates）如何分工？
经济数据日历（/stable/economic-calendar，可选 country, from）重在输出 country（国家/地区）与 event 等 11 列；而 Treasury Rates（美国国债收益率）返回 13 列，两者按查询维度互补。
在批量同步经济数据日历时，/stable/economic-calendar 的查询窗口与参数组合该如何安排？
推荐做法：在 /stable/economic-calendar 中传入 from/to 日期区间分批拉取；当 /stable/economic-calendar 正常返回含 country 的 JSON/CSV 后，即可直接合入本地策略宽表。
同模块相关接口对比
Economics Data本接口路径 /stable/economic-calendar，无必填参数。 同一模块「Economics Data」下共 4 个接口，下表列出其余 3 个， 按粒度与查询维度对比，避免选错接口。