Price Target Consensus目标价共识
该接口返回华尔街卖方分析师对指定股票的最新一致预期目标价分布,涵盖最高目标价、最低目标价、均值(共识值)与中位数。它是衡量当前股价相对卖方目标价潜在上涨空间(Upside)及评估市场多空估值分歧度的核心标尺。
https://quote-fmp.com/stable/price-target-consensus?symbol=AAPL数据更新周期
25 Minutes
接口说明
- 量化测算潜在上涨空间与安全边际:将接口返回的分析师共识目标价(或中位数目标价)与当前二级市场实时股价做比值计算,即可直接得出华尔街一致预期的潜在涨跌幅空间,作为价值选股与事件驱动策略的标准化估值锚点。
- 通过目标价极差评估多空分歧与尾部风险:除均值与中位数外,接口直接提供多头最乐观的最高目标价与空头最悲观的最低目标价。当最高与最低目标价呈现巨大剪刀差,或均值显著偏离中位数时,表明机构对该股商业模式或周期见顶存在剧烈分歧。
- 个股投研看板水位条可视化数据源:该接口字段高度凝练,单次请求即可拿到构建“当前股价在分析师最低—共识—最高目标价区间所处水位条”所需的全部四个锚点数值,是行情终端个股详情页不可或缺的卖方预期组件。
- 上下游关联接口:Financial Estimates(分析师预期查询) · Ratings Snapshot(评级快照) · Stock Quote(股票报价) · Income Statement(利润表)
请求参数
1 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
symbol | string | 必填 | AAPL | 证券代码,例如 AAPL 或 MSFT(美股直传代码如 AAPL;港股/英股/A股须带交易所后缀,如 0700.HK、600519.SS) |
调用代码示例
Python 关键代码对接 /stable/price-target-consensus(目标价共识,必填 symbol),从 DataFrame 可直接读取 targetHigh(目标价最高值)、targetLow(目标价最低值)、targetConsensus(一致目标价)。
resp = requests.get(
"https://quote-fmp.com/stable/price-target-consensus",
params={"symbol": "AAPL", "apikey": FMP_KEY},
timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 数值化核心指标列 targetHigh(目标价最高值)
df["targetHigh"] = pd.to_numeric(df["targetHigh"], errors="coerce")参数使用和避坑
2 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法:
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 定向上游请求 AAPL 目标价共识(symbol=AAPL) | symbol=AAPL | 请求 /stable/price-target-consensus?symbol=AAPL,产出该标的的 targetHigh、targetLow、targetConsensus(样本 400)等 5 列明细。 |
| 跨市场检索 0700.HK 的目标价共识数据 | symbol=0700.HK | 通过 symbol=0700.HK 请求 /stable/price-target-consensus,实现目标价共识在港股市场的同口径采集(含 targetHigh、targetLow、targetConsensus)。 |
/stable/price-target-consensus 针对目标价共识设计(必填 symbol),输出 targetHigh(400)等共 5 列,传参时请严格对齐必填 symbol示例。
/stable/price-target-consensus 共返回 5 列,入库 UPSERT 主键推荐取 (symbol),并对 targetHigh(400)与 targetLow(250) 执行 pd.to_numeric。
返回数据
5 个字段本接口示例响应共包含 5 个字段(数值型 4 个,文本/日期/布尔型 1 个)。下表列出全部字段名、类型、首条记录真实样本值与中文释义,实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
symbol | string | "AAPL" | 证券代码 |
targetHigh | number | 400 | 目标价最高值 |
targetLow | number | 250 | 目标价最低值 |
targetConsensus | number | 337.67 | 一致目标价 |
targetMedian | number | 340 | 目标价中位数 |
查看响应数据示例(原始 JSON)
[
{
"symbol": "AAPL",
"targetHigh": 400,
"targetLow": 250,
"targetConsensus": 337.67,
"targetMedian": 340
}
]常见问题解答(FAQ)
2 个问题为什么「Price Targets」同时提供目标价共识(/stable/price-target-consensus)和 目标价汇总(/stable/price-target-summary)两个端点?
/stable/price-target-consensus(目标价共识,必填 symbol)专门针对 targetHigh(目标价最高值)与 targetConsensus(一致目标价)等 5 个字段建模;若要结合 Price Target Summary(目标价汇总),可再调 /stable/price-target-summary(必填 symbol)。
在量化生产环境中,如何高效拉取目标价共识(/stable/price-target-consensus)的历史序列或批量截面?
建议向 /stable/price-target-consensus 传入标准 symbol(港股带 .HK、A 股带 .SS);拿到 targetHigh(目标价最高值)等数据后,先校验 len(data) > 0 再送入下游清洗管道。
同模块相关接口对比
Price Targets本接口路径 /stable/price-target-consensus,必填参数 symbol。 同一模块「Price Targets」下共 2 个接口,下表列出其余 1 个, 按粒度与查询维度对比,避免选错接口。
| 接口 | 路径 | 核心差异与适用场景 |
|---|---|---|
| 目标价汇总Price Target Summary | /stable/price-target-summary | 按时间窗口聚合汇总华尔街分析师对指定股票发布的最新目标价均值与报告数量 |