Price Target Summary目标价汇总
该接口按时间窗口(近 1 个月、近 1 个季度、近 1 年及历史全量)聚合汇总华尔街分析师对指定股票发布的最新目标价均值与报告数量。它通过对比短期与中长期目标价均值的水位变化,直观揭示卖方机构对个股目标价的动态修正趋势。
https://quote-fmp.com/stable/price-target-summary?symbol=AAPL数据更新周期
25 Minutes
接口说明
- 捕捉近期目标价上调与下修动量:全量分析师目标价往往混杂了数月前甚至一年前的陈旧报告。该接口将目标价按最近一个月、最近一季度与最近一年分段统计均值与样本数,通过比对“近一月目标价均值”与“近一年均值”的差值,可敏锐捕捉财报后华尔街集中上调目标价的边际动量。
- 评估短期卖方关注度与报告密集度:各时间段同步返回发布目标价的分析师报告篇数。当近一个月内的目标价发布数量相对季度常态显著放量时,通常意味着公司刚经历重大业绩催化、新产品发布或行业政策拐点,正处于机构高度重估窗口期。
- 跨时间窗口均值与横截面结构视角:一致目标价接口侧重给出当前横截面的最高、最低与中位数极值分布,而本汇总接口则从时间衰减维度拆解不同新旧程度报告的定中枢,两者结合可全面刻画卖方预期的位置与方向。
- 跨模块关联接口:Stock Grades(股票评级变动) · Historical Stock Grades(历史评级记录) · Earnings Report(公司财报数据) · Earnings Transcript(业绩电话会纪要检索)
请求参数
1 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
symbol | string | 必填 | AAPL | 证券代码,例如 AAPL 或 MSFT(美股直传代码如 AAPL;港股/英股/A股须带交易所后缀,如 0700.HK、600519.SS) |
调用代码示例
Python 关键代码调用 目标价汇总 端点 /stable/price-target-summary(必填 symbol),响应包含 lastMonthCount(近一月评级数)、lastMonthAvgPriceTarget(近一月平均目标价)、lastQuarterCount(近一季评级数) 等 10 个属性。
resp = requests.get(
"https://quote-fmp.com/stable/price-target-summary",
params={"symbol": "AAPL", "apikey": FMP_KEY},
timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 数值化核心指标列 lastMonthCount(近一月评级数)
df["lastMonthCount"] = pd.to_numeric(df["lastMonthCount"], errors="coerce")参数使用和避坑
2 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法:
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 拉取 AAPL 标的目标价汇总(symbol=AAPL) | symbol=AAPL | 指定标的代码 symbol=AAPL 调用 /stable/price-target-summary,直接提取 目标价汇总 的 lastMonthCount、lastMonthAvgPriceTarget、lastQuarterCount 数据。 |
| 非美交易所标的(symbol=0700.HK)查询目标价汇总 | symbol=0700.HK | 向 /stable/price-target-summary 传带交易所后缀的 symbol=0700.HK,拉取非美标的的 lastMonthCount、lastMonthAvgPriceTarget、lastQuarterCount 明细。 |
调用目标价汇总接口 /stable/price-target-summary(必填 symbol),可取回 lastMonthCount 等共 10 项指标;批量轮询时请结合网关 RPM 配额控制并发度。
归档目标价汇总(端点 /stable/price-target-summary)推荐采用 (symbol) 作为唯一主键;对 lastMonthCount(近一月评级数)等 8 个数值列需防范极端空值。
返回数据
10 个字段本接口示例响应共包含 10 个字段(数值型 8 个,文本/日期/布尔型 2 个)。下表列出全部字段名、类型、首条记录真实样本值与中文释义,实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
symbol | string | "AAPL" | 证券代码 |
lastMonthCount | number | 8 | 近一月评级数 |
lastMonthAvgPriceTarget | number | 333.75 | 近一月平均目标价 |
lastQuarterCount | number | 20 | 近一季评级数 |
lastQuarterAvgPriceTarget | number | 332.95 | 近一季平均目标价 |
lastYearCount | number | 67 | 近一年评级数 |
lastYearAvgPriceTarget | number | 304.86 | 近一年平均目标价 |
allTimeCount | number | 254 | 历史累计评级数 |
allTimeAvgPriceTarget | number | 230.51 | 历史平均目标价 |
publishers | string | "["StreetInsider","TheFly","Ben…" | 发布方 |
查看响应数据示例(原始 JSON)
[
{
"symbol": "AAPL",
"lastMonthCount": 8,
"lastMonthAvgPriceTarget": 333.75,
"lastQuarterCount": 20,
"lastQuarterAvgPriceTarget": 332.95,
"lastYearCount": 67,
"lastYearAvgPriceTarget": 304.86,
"allTimeCount": 254,
"allTimeAvgPriceTarget": 230.51,
"publishers": "[\"StreetInsider\",\"TheFly\",\"Benzinga\",\"Pulse 2.0\",\"TipRanks Contributor\",\"MarketWatch\",\"Investing\",\"Barrons\",\"Investor's Business Daily\"]"
}
]常见问题解答(FAQ)
2 个问题调用目标价汇总与 目标价共识 有何差异?/stable/price-target-summary 重点输出哪些指标?
访问 /stable/price-target-summary 拉取目标价汇总(必填 symbol)可拿到 lastMonthCount(8)与 lastMonthAvgPriceTarget;若需 /stable/price-target-consensus(必填 symbol)的 5 项数据,可改调 Price Target Consensus(目标价共识)。
如何利用 /stable/price-target-summary 的参数机制,高效完成目标价汇总的冷启动回填与盘后同步?
无论冷启动还是增量更新,都可按标的代码 symbol 请求 /stable/price-target-summary(非美标的需附交易所后缀);读取 lastMonthCount(样本 8)后建议先过滤无效记录再入库。
同模块相关接口对比
Price Targets本接口路径 /stable/price-target-summary,必填参数 symbol。 同一模块「Price Targets」下共 2 个接口,下表列出其余 1 个, 按粒度与查询维度对比,避免选错接口。
| 接口 | 路径 | 核心差异与适用场景 |
|---|---|---|
| 目标价共识Price Target Consensus | /stable/price-target-consensus | 华尔街卖方分析师对指定股票的最新一致预期目标价分布 |