Earnings Report公司财报数据
该接口返回指定股票的历史各期财报发布记录与未来已排期的财报披露日程。每条记录包含财报发布日期、每股收益（EPS）与营业收入的实际值及市场一致预期值，是开展个股业绩超预期（Beat/Miss）统计与财报事件回测的专用接口。
https://quote-fmp.com/stable/earnings?symbol=AAPL数据更新周期
1-2 Hours
接口说明
- 精确到真实披露日的事件回测底座：财务报表接口中的报告期截止日（如 12 月 31 日）并非市场获知财报信息的真实日期。该接口提供财报实际向市场公开披露的日期与最后更新时间，确保量化回测在计算财报后跳空反应与盈余公告后漂移（PEAD）时绝不引入前视偏差。
- EPS 与营收双维度预期差历史对账：单条记录同时并列展示当期实际披露的 EPS、营业收入与发布前的华尔街一致预期值。投研人员可一键统计某只股票在过去 12 个季度中的“双超预期”胜率及平均超预期幅度，评估管理层业绩指引的保守程度。
- 未来财报排期预警与事件策略布局：接口顶部自动包含未来几个季度已确认或预估的财报发布排期（实际值字段为空）。交易员可据此提前掌握个股下一次业绩大考的时间窗口，规避盲目持仓过财报的黑天鹅风险或提前布局波动率交易。
- 上下游关联接口：IPOs Disclosure（IPO 申报文件） · IPOs Prospectus（IPO 招股书） · Press Releases（公司新闻稿） · Earnings Transcript（业绩电话会纪要检索）
请求参数
3 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
symbol | string | 必填 | AAPL | 证券代码，例如 AAPL 或 MSFT（美股直传代码如 AAPL；港股/英股/A股须带交易所后缀，如 0700.HK、600519.SS） |
limit | number | 可选 | 100 | 返回结果条数上限，用于控制单次响应大小。 |
includeReportTimes | boolean | 可选 | false | 是否在财报数据中附带报告发布时间（盘前/盘后）。 |
调用代码示例
Python 关键代码对接 /stable/earnings（公司财报数据，必填 symbol），从 DataFrame 可直接读取 epsActual（每股收益实际值）、epsEstimated（每股收益预期值）、revenueActual（营收实际值）。
resp = requests.get(
"https://quote-fmp.com/stable/earnings",
params={"symbol": "AAPL", "limit": 100, "includeReportTimes": "false", "apikey": FMP_KEY},
timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 按 date 升序重排并数值化 epsEstimated（每股收益预期值）
df["epsEstimated"] = pd.to_numeric(df["epsEstimated"], errors="coerce")
df = df.sort_values("date").reset_index(drop=True)参数使用和避坑
3 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法：
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 定向上游请求 AAPL 公司财报数据（symbol=AAPL） | symbol=AAPL | 请求 /stable/earnings?symbol=AAPL，产出该标的的 epsActual、epsEstimated、revenueActual（样本 null）等 7 列明细。 |
| 设置返回条数上限（limit=100）回溯 AAPL 公司财报数据 | symbol=AAPL&limit=100 | 通过条数上限参数请求 /stable/earnings，单次拉回 AAPL 更长历史周期的 epsActual、epsEstimated、revenueActual。 |
| 跨市场检索 0700.HK 的公司财报数据数据 | symbol=0700.HK | 通过 symbol=0700.HK 请求 /stable/earnings，实现公司财报数据在港股市场的同口径采集（含 epsActual、epsEstimated、revenueActual）。 |
/stable/earnings 针对公司财报数据设计（必填 symbol），输出 epsActual（null）和 epsEstimated（每股收益预期值）共 7 列，传参时请严格对齐必填 symbol示例。
/stable/earnings 共返回 7 列，入库 UPSERT 主键推荐取 (symbol, date)，并对 epsEstimated（1.88）与 revenueEstimated（109038900000） 执行 pd.to_numeric。
返回数据
7 个字段本接口示例响应共包含 7 个字段（数值型 2 个，文本/日期/布尔型 5 个）。下表列出全部字段名、类型、首条记录真实样本值与中文释义，实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
symbol | string | "AAPL" | 证券代码 |
date | string | "2026-07-30" | 日期 |
epsActual | null | null | 每股收益实际值 |
epsEstimated | number | 1.88 | 每股收益预期值 |
revenueActual | null | null | 营收实际值 |
revenueEstimated | number | 109038900000 | 营收预期值 |
lastUpdated | string | "2026-07-30" | 最近更新时间 |
查看响应数据示例（原始 JSON）
[
{
"symbol": "AAPL",
"date": "2026-07-30",
"epsActual": null,
"epsEstimated": 1.88,
"revenueActual": null,
"revenueEstimated": 109038900000,
"lastUpdated": "2026-07-30"
}
]常见问题解答（FAQ）
2 个问题为什么「Earnings」同时提供公司财报数据（/stable/earnings）和 财报日历（/stable/earnings-calendar）两个端点？
/stable/earnings（公司财报数据，必填 symbol）专门针对 epsActual（每股收益实际值）与 revenueActual（营收实际值）等 7 个字段建模；若要结合 Earnings Calendar（财报日历），可再调 /stable/earnings-calendar（无必填参数）。
在量化生产环境中，如何高效拉取公司财报数据（/stable/earnings）的历史序列或批量截面？
建议在 /stable/earnings 中显式调大 limit 参数（如 limit=100）单次拉取多期记录；拿到 epsActual（每股收益实际值）等数据后，先校验 len(data) > 0 再送入下游清洗管道。
同模块相关接口对比
Earnings本接口路径 /stable/earnings，必填参数 symbol。 同一模块「Earnings」下共 2 个接口，下表列出其余 1 个， 按粒度与查询维度对比，避免选错接口。
| 接口 | 路径 | 核心差异与适用场景 |
|---|---|---|
| 财报日历Earnings Calendar | /stable/earnings-calendar | 按起止日期区间返回全市场上市公司的财报披露日程表，涵盖已发布财报的实际值与预期值对比 |