Stock Grades Summary评级共识汇总
该接口返回单只股票当前的华尔街分析师评级共识横截面汇总，直接统计处于强力买入、买入、持有、卖出、强力卖出五个档位的机构家数，并输出最终综合共识结论。它是快速把握当前卖方多空阵营对比的轻量级快照接口。
https://quote-fmp.com/stable/grades-consensus?symbol=AAPL数据更新周期
5-6 Hours
接口说明
- 市场情绪评估：快速了解市场对一只股票的总体倾向，是偏买入、持有还是卖出，传入
symbol后可提取strongBuy（强力买入）、buy（买入）与hold（持有） 等字段，便于直接写入量化因子库。 - 计算量化看多占比与卖方覆盖广度：在横截面多因子打分中，投研团队可直接利用该接口返回的五档人数计算“看多机构占比”与“总覆盖机构家数”，既能筛选出获华尔街高度一致看好的标的，也能识别出尚未被卖方充分挖掘的低覆盖潜力股（Under-covered Gems）。
- 同模块三大评级接口的分工与协同定位：在本模块中，评级流水接口看“具体哪家大行刚改了观点”，历史评级接口看“过去几年多空人数如何演变”，而本汇总接口则提供“当下这一刻的多空阵营总比分”，非常适合直接驱动终端页面的评级分布柱状图。
- 跨模块关联接口：Ratings Snapshot（评级快照） · Historical Ratings（历史财务评分） · Stock Quote（股票报价） · Income Statement（利润表）
请求参数
1 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
symbol | string | 必填 | AAPL | 证券代码，例如 AAPL 或 MSFT（美股直传代码如 AAPL；港股/英股/A股须带交易所后缀，如 0700.HK、600519.SS） |
调用代码示例
Python 关键代码评级共识汇总由 /stable/grades-consensus 提供（必填 symbol），明细涵盖 strongBuy（强力买入）、buy（买入）、hold（持有） 等 7 列。
resp = requests.get(
"https://quote-fmp.com/stable/grades-consensus",
params={"symbol": "AAPL", "apikey": FMP_KEY},
timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 数值化核心指标列 strongBuy（强力买入）
df["strongBuy"] = pd.to_numeric(df["strongBuy"], errors="coerce")参数使用和避坑
2 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法：
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 单票检索 AAPL 的评级共识汇总数据 | symbol=AAPL | 在 /stable/grades-consensus 中锁定 AAPL，返回 评级共识汇总 对应的 strongBuy、buy、hold 明细列表。 |
| 非美交易所标的（symbol=0700.HK）查询评级共识汇总 | symbol=0700.HK | 向 /stable/grades-consensus 传带交易所后缀的 symbol=0700.HK，拉取非美标的的 strongBuy、buy、hold 明细。 |
解析 /stable/grades-consensus 产出的评级共识汇总（必填 symbol）时，注意 strongBuy（如 1）在部分标的上可能为 null 或空串，下游关联前需做空值过滤。
本地维护评级共识汇总底表（源自 /stable/grades-consensus）时，主键定为 (symbol)；读取 strongBuy（强力买入，样本 1）做横截面标准化前先剔除 NaN。
返回数据
7 个字段本接口示例响应共包含 7 个字段（数值型 5 个，文本/日期/布尔型 2 个）。下表列出全部字段名、类型、首条记录真实样本值与中文释义，实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
symbol | string | "AAPL" | 证券代码 |
strongBuy | number | 1 | 强力买入 |
buy | number | 70 | 买入 |
hold | number | 32 | 持有 |
sell | number | 8 | 卖出 |
strongSell | number | 0 | 强力卖出 |
consensus | string | "Buy" | 一致预期评级 |
查看响应数据示例（原始 JSON）
[
{
"symbol": "AAPL",
"strongBuy": 1,
"buy": 70,
"hold": 32,
"sell": 8,
"strongSell": 0,
"consensus": "Buy"
}
]常见问题解答（FAQ）
2 个问题在实际量化建模中，评级共识汇总与 股票评级变动（/stable/grades）是如何互补联动的？
向 /stable/grades-consensus 请求评级共识汇总需遵循必填 symbol，返回 strongBuy（强力买入，样本 1）等 7 项；而 Stock Grades（股票评级变动）遵循必填 symbol并返回 6 项。
回测需要多期或多标的评级共识汇总，调用 /stable/grades-consensus 应该如何组织请求？
您可以按标的代码 symbol 请求 /stable/grades-consensus（非美标的需附交易所后缀）；在落盘 评级共识汇总 的 strongBuy 与 buy 时，建议将原始响应分批转换为列式存储。
同模块相关接口对比
Upgrades Downgrades本接口路径 /stable/grades-consensus，必填参数 symbol。 同一模块「Upgrades Downgrades」下共 3 个接口，下表列出其余 2 个， 按粒度与查询维度对比，避免选错接口。