Earnings Calendar财报日历
该接口按起止日期区间返回全市场上市公司的财报披露日程表，涵盖已发布财报的实际值与预期值对比，以及未来待发布财报的排期预告与市场一致预期。它是财报季全市场业绩跟踪、盘前盘后交易监控与事件驱动选股的核心日历工具。
https://quote-fmp.com/stable/earnings-calendar数据更新周期
1-2 Hours
接口说明
- 财报季全市场发榜排期与盘前监控：在美股财报密集披露周，每天有数百家公司集中发榜。通过指定本周或下周的日期区间调用该接口，投研团队可一次性生成全市场重磅财报观察日历，并提前获取华尔街对每家待发榜公司的 EPS 与营收一致预期基准。
- 盘中实时捕捉全市场财报超预期异动：在财报披露当日定时轮询该日历，一旦某家公司财报落地、实际 EPS 与实际营收字段由空值被填充，量化脚本即可在秒级内计算出实际值相对预期值的超预期百分比，联动行情接口捕捉首波业绩动量。
- 多策略组合财报窗口期风控避险：许多纯技术面、统计套利或低波动率策略在个股发布财报当日面临剧烈的跳空风险。风控系统可每日拉取未来 3 至 5 天的财报日历，自动暂停对即将发榜标的的新开仓指令或提前平仓降杠杆。
- 关联数据线接口：Dividends Company（公司分红派息） · Dividends Calendar（分红派息日历） · Stock Price and Volume Data（日线完整行情） · Global Exchange Market Hours（全球交易所交易时段）
请求参数
4 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
from | date | 可选 | 2026-03-06 | 查询起始日期，格式 YYYY-MM-DD，包含当天。 |
to | date | 可选 | 2026-06-06 | 查询结束日期，格式 YYYY-MM-DD，包含当天。 |
page | number | 可选 | 0 | 分页页码，从 0 开始，配合每页条数翻页取更多数据（从 0 起算的分页游标；当响应返回空数组 [] 时代表已翻至历史末页） |
includeReportTimes | boolean | 可选 | false | 是否在财报数据中附带报告发布时间（盘前/盘后）。 |
调用代码示例
Python 关键代码拉取 财报日历 只需访问 /stable/earnings-calendar（可选 from, to），结果涵盖 epsActual（每股收益实际值）、epsEstimated（每股收益预期值）、revenueActual（营收实际值）（epsActual=0.549）。
resp = requests.get(
"https://quote-fmp.com/stable/earnings-calendar",
params={"from": "2026-03-06", "to": "2026-06-06", "page": 0, "includeReportTimes": "false", "apikey": FMP_KEY},
timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 按 date 升序重排并数值化 epsActual（每股收益实际值）
df["epsActual"] = pd.to_numeric(df["epsActual"], errors="coerce")
df = df.sort_values("date").reset_index(drop=True)参数使用和避坑
2 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法：
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 传入一季度起止日期提取财报日历列表 | from=2025-01-01&to=2025-03-31 | 请求 /stable/earnings-calendar 并指定 2025 一季度边界，一次拿齐该时段的 epsActual、epsEstimated、revenueActual 等核心字段。 |
| 分段拉取 2024 下半年财报日历全量记录 | from=2024-07-01&to=2024-12-31 | 通过半年期滑窗参数请求 /stable/earnings-calendar，稳定拉取 2024H2 期间的 epsActual、epsEstimated、revenueActual 记录。 |
在财报日历（/stable/earnings-calendar）中，首条样本的 epsActual 为 0.549、epsEstimated 为 0.501；批量采集时请按可选 from, to校验传参格式。
存储财报日历（/stable/earnings-calendar）数据时，联合键 (symbol, date) 能唯一标识每条截面；注意 epsActual（每股收益实际值，样本 0.549）采用原始计价单位。
返回数据
7 个字段本接口示例响应共包含 7 个字段（数值型 4 个，文本/日期/布尔型 3 个）。下表列出全部字段名、类型、首条记录真实样本值与中文释义，实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
symbol | string | "GRG.L" | 证券代码 |
date | string | "2026-07-29" | 日期 |
epsActual | number | 0.549 | 每股收益实际值 |
epsEstimated | number | 0.501 | 每股收益预期值 |
revenueActual | number | 1101500000 | 营收实际值 |
revenueEstimated | number | 1086300000 | 营收预期值 |
lastUpdated | string | "2026-07-30" | 最近更新时间 |
查看响应数据示例（原始 JSON）
[
{
"symbol": "GRG.L",
"date": "2026-07-29",
"epsActual": 0.549,
"epsEstimated": 0.501,
"revenueActual": 1101500000,
"revenueEstimated": 1086300000,
"lastUpdated": "2026-07-30"
}
]常见问题解答（FAQ）
2 个问题使用「Earnings」接口族时，财报日历（可选 from, to）与 公司财报数据（必填 symbol）怎么选？
按输入参数看，/stable/earnings-calendar（财报日历）为可选 from, to，产出 epsActual（0.549）等 7 列；/stable/earnings（Earnings Report（公司财报数据））为必填 symbol，产出 7 列。
在自动化流水线中对接财报日历（/stable/earnings-calendar），怎样平衡拉取深度与请求效率？
最佳实践是按日历窗口设置 from 和 to 边界调用 /stable/earnings-calendar；解析响应中的 epsActual（如 0.549）前，请确保对异常空值和网络超时设置退避重试。
同模块相关接口对比
Earnings本接口路径 /stable/earnings-calendar，无必填参数。 同一模块「Earnings」下共 2 个接口，下表列出其余 1 个， 按粒度与查询维度对比，避免选错接口。
| 接口 | 路径 | 核心差异与适用场景 |
|---|---|---|
| 公司财报数据Earnings Report | /stable/earnings | 指定股票的历史各期财报发布记录与未来已排期的财报披露日程 |