Upgrades Downgrades Consensus Bulk评级共识批量数据

Q: /stable/upgrades-downgrades-consensus-bulk 端点（评级共识批量数据）的参数设计与同模块的 公司概况批量 有什么区别？

工程上常将两者配合：用 评级共识批量数据（/stable/upgrades-downgrades-consensus-bulk，免业务参数）拉取 strongBuy 与 buy 等 7 列，同时用 Company Profile Bulk（公司概况批量）补充 36 列关联信息。

该接口批量获取全部股票代码的分析师评级总览，一次请求即可拿到分析师上调评级、下调评级与共识推荐，洞察市场对个股的整体预期。

GEThttps://quote-fmp.com/stable/upgrades-downgrades-consensus-bulk

数据更新周期

4-6 Hours

接口说明

分析师推荐：一次请求获取多只股票的详细评级，如强力买入、买入、持有、卖出、强力卖出，调用后可覆盖 strongBuy（强力买入）、buy（买入）与 hold（持有）等高频字段，适合定时批量归档至本地数据库。
共识评级：查看每只股票基于分析师推荐的整体共识，帮助评估市场的普遍情绪，通过单次 CSV 流式响应完成全市场数万标的截面同步。
上调与下调趋势：跟踪各代码近期的评级上调或下调，识别潜在投资机会或风险，在多因子回测管道里，常联合「ETF持股批量查询」一起采集以丰富特征维度。
CSV 文本流格式：/stable/upgrades-downgrades-consensus-bulk 直接下发带表头的 CSV 文本流而非 JSON 数组，请使用 pd.read_csv(io.StringIO(resp.text)) 流式读取。
上下游关联接口：Income Statement Bulk（利润表批量获取） · Income Statement Growth Bulk（利润表增长批量获取） · Financial Statement Symbols List（报表公司清单） · Income Statement（利润表）

调用代码示例

Python 关键代码

/stable/upgrades-downgrades-consensus-bulk 单次流式返回全市场评级共识批量数据（含 strongBuy（强力买入）、buy（买入）、hold（持有）），不可调 resp.json()，建议用 pd.read_csv 解析后存为 Parquet。

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

import io
resp = requests.get(
    "https://quote-fmp.com/stable/upgrades-downgrades-consensus-bulk",
    params={"apikey": FMP_KEY},
    timeout=60,
)
resp.raise_for_status()
# 评级共识批量数据返回 CSV 文本流，使用 io.StringIO 配合 pd.read_csv 解析
df = pd.read_csv(io.StringIO(resp.text))
df["strongBuy"] = pd.to_numeric(df["strongBuy"], errors="coerce")

参数使用和避坑

3 组参数组合 · 2 条避坑

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

投研场景	Query 参数组合示例	返回数据特征与用途
一次性拉取全量评级共识批量数据初始化本地主表	`GET /stable/upgrades-downgrades-consensus-bulk（免参数）`	该接口不吃 Query 条件：请求 /stable/upgrades-downgrades-consensus-bulk 直接下发全表 7 列，strongBuy、buy、hold 全在其中。
以 symbol 为唯一键覆盖写入，避免全表重复	`GET /stable/upgrades-downgrades-consensus-bulk → upsert on symbol`	落库键选 symbol（如），7 列逐行覆盖；同模块没有带参接口，想补单条只能再拉一次全表。
落库后自检：symbol 唯一性与 strongBuy 空值率	`GET /stable/upgrades-downgrades-consensus-bulk → count(distinct symbol) / null_ratio(strongBuy)`	先用 symbol 去重计数校验 7 列是否完整落库，再看 strongBuy（样本 0）的空值率；两者都正常才认为该批次可用。

CSV 流式解析评级共识批量数据：/stable/upgrades-downgrades-consensus-bulk 下发 CSV 文本流，切勿调 resp.json()

评级共识批量数据接口 /stable/upgrades-downgrades-consensus-bulk 采用 CSV 流格式下发 strongBuy（0）等全市场截面，请求时建议设 timeout=60 并以 io.StringIO 解析。

落库主键与口径/stable/upgrades-downgrades-consensus-bulk（评级共识批量数据）：strongBuy 口径核对与 (symbol) 主键

在 /stable/upgrades-downgrades-consensus-bulk 的返回结构中，strongBuy（0）构成核心载荷，本地表以 (symbol) 保证幂等入库。

返回数据

7 个字段

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

字段	类型	示例值	说明
`symbol`	string	`""`	证券代码
`strongBuy`	string	`"0"`	强力买入
`buy`	string	`"1"`	买入
`hold`	string	`"1"`	持有
`sell`	string	`"0"`	卖出
`strongSell`	string	`"0"`	强力卖出
`consensus`	string	`"Buy"`	一致预期评级

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

[
{
"symbol": "",
"strongBuy": "0",
"buy": "1",
"hold": "1",
"sell": "0",
"strongSell": "0",
"consensus": "Buy"
}
]

常见问题解答（FAQ）

2 个问题

/stable/upgrades-downgrades-consensus-bulk 端点（评级共识批量数据）的参数设计与同模块的公司概况批量有什么区别？

工程上常将两者配合：用评级共识批量数据（/stable/upgrades-downgrades-consensus-bulk，免业务参数）拉取 strongBuy 与 buy 等 7 列，同时用 Company Profile Bulk（公司概况批量）补充 36 列关联信息。

使用 /stable/upgrades-downgrades-consensus-bulk 采集评级共识批量数据构建因子库，推荐的请求切片方式是什么？

采集 /stable/upgrades-downgrades-consensus-bulk 的核心技巧是每日定时调用一次 /stable/upgrades-downgrades-consensus-bulk 将全量字典同步至本地；这能确保评级共识批量数据的 strongBuy 与 buy 连续完整且无截断遗漏。

同模块相关接口对比

Profile

本接口路径 /stable/upgrades-downgrades-consensus-bulk，无必填参数。同一模块「Profile」下共 11 个接口，下表列出其余 10 个，按粒度与查询维度对比，避免选错接口。

接口	路径	核心差异与适用场景
公司概况批量Company Profile Bulk	`/stable/profile-bulk`	以 CSV 流式分片形式一次性返回全市场上市公司的档案主表
评级批量Stock Rating Bulk	`/stable/rating-bulk`	以单次 CSV 流式响应批量导出全市场股票的综合财务评级快照
DCF 批量估值DCF Valuations Bulk	`/stable/dcf-bulk`	一次请求即可返回多个代码的现金流折现（DCF）估值，含隐含价格变动空间与百分比差异
财务评分批量Financial Scores Bulk	`/stable/scores-bulk`	以单次 CSV 流式响应批量返回全市场股票的 Piotroski F-Score与 Altman Z-Score截面
目标价汇总批量Price Target Summary Bulk	`/stable/price-target-summary-bulk`	以单次 CSV 流式响应批量导出全市场覆盖股票的分析师目标价汇总截面
ETF持股批量查询ETF Holder Bulk	`/stable/etf-holder-bulk`	ETF 持仓资产的详细清单，每项资产的持股数量、权重占比、市值
TTM 关键指标批量Key Metrics TTM Bulk	`/stable/key-metrics-ttm-bulk`	以单次 CSV 流式响应批量导出全市场上市公司的滚动十二个月（TTM）关键财务指标截面
TTM 财务比率批量Ratios TTM Bulk	`/stable/ratios-ttm-bulk`	以单次 CSV 流式响应批量导出全市场上市公司的滚动十二个月（TTM）财务比率截面
同业公司批量Stock Peers Bulk	`/stable/peers-bulk`	以单次 CSV 流式响应批量导出全市场上市公司的同行业可比公司映射全表
批量财报超预期Earnings Surprises Bulk	`/stable/earnings-surprises-bulk`	一次返回多家公司年度财报意外数据，实际 EPS 与预期 EPS 对比

Bulk（批量数据）全部接口目录 →

需要稳定访问评级共识批量数据数据？注册即可获取专属 API Key，免费体验全部接口。

免费试用 1 个月