Financial Estimates分析师预期查询

该接口提供华尔街卖方分析师对单只股票未来多期（年度或季度）的财务预测共识数据，涵盖预期营业收入、EBITDA、EBIT、净利润及每股收益（EPS）的高低区间与均值。它是计算前瞻估值倍数（Forward P/E）与捕捉业绩预期差的核心数据源。

GEThttps://quote-fmp.com/stable/analyst-estimates?symbol=AAPL&period=annual&page=0&limit=10

数据更新周期

Daily

接口说明

前瞻估值建模核心分母输入：二级市场定价反映的是公司未来盈利而非历史静态业绩。通过该接口获取未来 1 至 3 个财年或季度的共识 EPS 与预期营收均值，可直接计算动态前瞻市盈率（Forward P/E）与 PEG 指标，避免静态估值在业绩高增或周期拐点时的失真。
预测分歧度与卖方覆盖深度刻画：单条记录不仅提供营收与 EPS 的一致预期均值，还同步给出预测最高值、最低值及参与预测的分析师人数。量化模型可利用高低极差比衡量华尔街对该公司未来业绩的分歧程度，挖掘低分歧确定性溢价或高分歧博弈机会。
财报季预期差测算与历史预期回溯：接口既包含对未来财年的远期展望，也保留了过往各报告期的历史一致预期基准。将历史预期值与实际披露财报对齐，可在回测中复原当时市场眼中的超预期幅度，构建纯正的基本面预期差动量因子。
跨模块关联接口：Stock Grades Summary（评级共识汇总） · Ratings Snapshot（评级快照） · Earnings Transcript（业绩电话会纪要检索） · Ratings Summary by Symbol（个股评级汇总）

请求参数

4 个参数

参数	类型	要求	示例	说明
`symbol`	string	必填	`AAPL`	证券代码，例如 AAPL 或 MSFT（美股直传代码如 AAPL；港股/英股/A股须带交易所后缀，如 0700.HK、600519.SS）
`period`	string	必填	`annual,quarter`	报告周期：annual（年度）、quarter（季度）、ttm（滚动十二个月）（单值枚举：常规报表传 annual 或 quarter，Bulk 传 Q1..Q4 或 FY；每次仅传单值）
`page`	number	可选	`0`	分页页码，从 0 开始，配合每页条数翻页取更多数据（从 0 起算的分页游标；当响应返回空数组 [] 时代表已翻至历史末页）
`limit`	number	可选	`10`	返回结果条数上限，用于控制单次响应大小。

调用代码示例

Python 关键代码

请求 /stable/analyst-estimates 拉取分析师预期查询（必填 symbol, period），可直取 revenueLow（营收预期最低值）、revenueHigh（营收预期最高值）、revenueAvg（营收预期均值）（如 revenueLow=648228509004）共 22 项。

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

resp = requests.get(
    "https://quote-fmp.com/stable/analyst-estimates",
    params={"symbol": "AAPL", "period": "annual", "page": 0, "limit": 10, "apikey": FMP_KEY},
    timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 按 date 升序重排并数值化 revenueLow（营收预期最低值）
df["revenueLow"] = pd.to_numeric(df["revenueLow"], errors="coerce")
df = df.sort_values("date").reset_index(drop=True)

参数使用和避坑

3 组参数组合 · 2 条避坑

以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法：

投研场景	Query 参数组合示例	返回数据特征与用途
检索 AAPL 年度周期分析师预期查询明细（annual）	`symbol=AAPL&period=annual`	以年报粒度 period=annual 查询 /stable/analyst-estimates，直接拿到 AAPL 的 revenueLow、revenueHigh、revenueAvg（样本 revenueLow=648228509004）。
高频跟踪 AAPL 季度分析师预期查询（quarter）	`symbol=AAPL&period=quarter`	指定季报参数 period=quarter，从 /stable/analyst-estimates 读取 AAPL 最新季度的 revenueLow、revenueHigh、revenueAvg。
港股龙头 0700.HK 分析师预期查询采集	`symbol=0700.HK&period=annual`	将 symbol 设为 0700.HK 查询 /stable/analyst-estimates，实现港股与美股同口径的 revenueLow、revenueHigh、revenueAvg 比较。

时序与查询边界/stable/analyst-estimates 跨市场细节：必填 symbol, period后缀与 revenueLow 读取

分析师预期查询由 /stable/analyst-estimates 承载（必填 symbol, period），核心列包括 revenueLow（营收预期最低值，样本 648228509004）与 revenueHigh；查询非美标的时请确认后缀格式正确。

落库主键与口径分析师预期查询：按 (symbol, date) 幂等去重并保持 revenueLow 精度

将分析师预期查询（/stable/analyst-estimates）落库时，建议以 (symbol, date) 建联合唯一索引；核心列 revenueLow（营收预期最低值，样本 648228509004）宜转为 float64 处理。

返回数据

22 个字段

本接口示例响应共包含 22 个字段（数值型 20 个，文本/日期/布尔型 2 个）。下表列出全部字段名、类型、首条记录真实样本值与中文释义，实际返回会因接口与数据状态有所不同。

字段	类型	示例值	说明
`symbol`	string	`"AAPL"`	证券代码
`date`	string	`"2030-09-27"`	日期
`revenueLow`	number	`648228509004`	营收预期最低值
`revenueHigh`	number	`735022980353`	营收预期最高值
`revenueAvg`	number	`679000000000`	营收预期均值
`ebitdaLow`	number	`233968328102`	EBITDA 预期最低值
`ebitdaHigh`	number	`265295486763`	EBITDA 预期最高值
`ebitdaAvg`	number	`245074834838`	EBITDA 预期均值
`ebitLow`	number	`217109092822`	EBIT 预期最低值
`ebitHigh`	number	`246178886382`	EBIT 预期最高值
`ebitAvg`	number	`227415289483`	EBIT 预期均值
`netIncomeLow`	number	`191547261069`	净利润预期最低值
`netIncomeHigh`	number	`225370398908`	净利润预期最高值
`netIncomeAvg`	number	`203538714818`	净利润预期均值
`sgaExpenseLow`	number	`41721580524`	销售管理费用预期最低值
`sgaExpenseHigh`	number	`47307886087`	销售管理费用预期最高值
`sgaExpenseAvg`	number	`43702109337`	销售管理费用预期均值
`epsAvg`	number	`13.565`	每股收益预期均值
`epsHigh`	number	`15.01999`	每股收益预期最高值
`epsLow`	number	`12.76582`	每股收益预期最低值
`numAnalystsRevenue`	number	`16`	提供营收预期的分析师人数
`numAnalystsEps`	number	`7`	提供每股收益预期的分析师人数

查看响应数据示例（原始 JSON）

[
{
"symbol": "AAPL",
"date": "2030-09-27",
"revenueLow": 648228509004,
"revenueHigh": 735022980353,
"revenueAvg": 679000000000,
"ebitdaLow": 233968328102,
"ebitdaHigh": 265295486763,
"ebitdaAvg": 245074834838,
"ebitLow": 217109092822,
"ebitHigh": 246178886382,
"ebitAvg": 227415289483,
"netIncomeLow": 191547261069,
"netIncomeHigh": 225370398908,
"netIncomeAvg": 203538714818,
"sgaExpenseLow": 41721580524,
"sgaExpenseHigh": 47307886087,
"sgaExpenseAvg": 43702109337,
"epsAvg": 13.565,
"epsHigh": 15.01999,
"epsLow": 12.76582,
"numAnalystsRevenue": 16,
"numAnalystsEps": 7
}
]

常见问题解答（FAQ）

2 个问题

分析师财务预期能当作已经披露的业绩使用吗？

不能。revenueLow、revenueHigh、revenueAvg 描述分析师预测区间及平均预期，不是公司已经确认的营业收入。预测与实际业绩比较时，先按 symbol、报告期和 annual/quarter 口径对齐，再调用利润表取得实际收入；历史回测还需要当时可获得的预测版本，不能把今天的预期回填成过去已知的信息。

如何确保从 /stable/analyst-estimates 拉取的分析师预期查询覆盖完整目标区间且不触发空跑？

为保障采集稳定性，请在 /stable/analyst-estimates 中固定 limit 并从 page=0 起逐页拉取；并针对 /stable/analyst-estimates 返回的 revenueLow（如 648228509004）建立自动化数据质量断言。

同分类关联接口对比

分析师数据

本接口路径 /stable/analyst-estimates（所属子模块「Analyst Estimates」仅此 1 个接口），必填参数 symbol、period。下表列出同属「分析师数据」大类下的 6 个关联接口，方便横向对比与上下游联动：

接口	路径	核心差异与适用场景
评级快照Ratings Snapshot	`/stable/ratings-snapshot`	单只股票基于多维财务基本面量化模型计算的最新综合评级快照及总得分
历史财务评分Historical Ratings	`/stable/ratings-historical`	按时间序列返回指定股票在过往各交易日的历史综合财务评级与六大基本面子项得分
目标价汇总Price Target Summary	`/stable/price-target-summary`	按时间窗口聚合汇总华尔街分析师对指定股票发布的最新目标价均值与报告数量
目标价共识Price Target Consensus	`/stable/price-target-consensus`	华尔街卖方分析师对指定股票的最新一致预期目标价分布
股票评级变动Stock Grades	`/stable/grades`	知名投行与研究机构对指定股票发布的最新评级变动事件流水
历史评级记录Historical Stock Grades	`/stable/grades-historical`	按历史时间序列返回指定股票在过往各报告节点的多档分析师评级人数分布快照

Analyst（分析师数据）全部接口目录 →

需要稳定访问分析师预期查询数据？注册即可获取专属 API Key，免费体验全部接口。

免费试用 1 个月