Stock Grades股票评级变动
该接口返回知名投行与研究机构（如摩根士丹利、高盛、巴克莱等）对指定股票发布的最新评级变动事件流水。逐条记录评级日期、机构名称、原评级、新评级及评级动作（上调、下调、维持或首次覆盖），用于实时捕捉外资大行的观点转向。
https://quote-fmp.com/stable/grades?symbol=AAPL数据更新周期
2 Hours
接口说明
- 实时监控大行评级转向与事件催化：美股市场对头部华尔街投行（Tier-1 Banks）的评级变更极为敏感，盘前突发的评级上调（Upgrade）或下调（Downgrade）往往直接引发当日股价跳空异动。该接口按时间倒序提供最新评级动作明细，是盘前事件驱动交易的核心信号源。
- 追踪机构观点跃迁与首次覆盖信号：每条记录完整对比了变更前的旧评级与变更后的新评级（如从“持有”跃升至“超配”，或首次覆盖给予“买入”）。量化系统可据此区分“边际微调”与“方向性看多/看空反转”，并对新兴成长股首次获得大行覆盖的事件进行专项捕捉。
- 头部投行白名单筛选与行为跟踪：由于不同研究机构的市场影响力与历史准确度存在差异，接口明确披露每条评级背后的具体机构名称，便于投研团队建立核心投行白名单，仅对高权重机构的评级转向赋予交易信号权重。
- 上下游关联接口：Price Target Summary（目标价汇总） · Price Target Consensus（目标价共识） · Earnings Transcript（业绩电话会纪要检索） · Ratings Summary by Symbol（个股评级汇总）
请求参数
1 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
symbol | string | 必填 | AAPL | 证券代码，例如 AAPL 或 MSFT（美股直传代码如 AAPL；港股/英股/A股须带交易所后缀，如 0700.HK、600519.SS） |
调用代码示例
Python 关键代码从 /stable/grades 同步股票评级变动（必填 symbol），一次拿齐 gradingCompany（评级机构）、previousGrade（原评级）、newGrade（新评级）（样本值 gradingCompany=Morgan Stanley）。
resp = requests.get(
"https://quote-fmp.com/stable/grades",
params={"symbol": "AAPL", "apikey": FMP_KEY},
timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 提取 股票评级变动 核心列：symbol, date, gradingCompany, previousGrade
df = df[["symbol", "date", "gradingCompany", "previousGrade"]].dropna(how="all")参数使用和避坑
2 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法：
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 定向上游请求 AAPL 股票评级变动（symbol=AAPL） | symbol=AAPL | 请求 /stable/grades?symbol=AAPL，产出该标的的 gradingCompany、previousGrade、newGrade（样本 Morgan Stanley）等 6 列明细。 |
| 跨市场检索 0700.HK 的股票评级变动数据 | symbol=0700.HK | 通过 symbol=0700.HK 请求 /stable/grades，实现股票评级变动在港股市场的同口径采集（含 gradingCompany、previousGrade、newGrade）。 |
针对 /stable/grades（股票评级变动，必填 symbol），返回首行的 gradingCompany 为 Morgan Stanley、previousGrade 为 Overweight；入库前请先拦截 200 [] 空响应。
持久化 /stable/grades（股票评级变动）的 6 个字段时，自然键取 (symbol, date)；标识列 gradingCompany（样本 Morgan Stanley）请保持大小写与上游一致。
返回数据
6 个字段本接口示例响应共包含 6 个字段（数值型 0 个，文本/日期/布尔型 6 个）。下表列出全部字段名、类型、首条记录真实样本值与中文释义，实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
symbol | string | "AAPL" | 证券代码 |
date | string | "2026-07-23" | 日期 |
gradingCompany | string | "Morgan Stanley" | 评级机构 |
previousGrade | string | "Overweight" | 原评级 |
newGrade | string | "Overweight" | 新评级 |
action | string | "maintain" | 评级动作 |
查看响应数据示例（原始 JSON）
[
{
"symbol": "AAPL",
"date": "2026-07-23",
"gradingCompany": "Morgan Stanley",
"previousGrade": "Overweight",
"newGrade": "Overweight",
"action": "maintain"
}
]常见问题解答（FAQ）
2 个问题在「Upgrades Downgrades」下，股票评级变动（/stable/grades）与 历史评级记录（/stable/grades-historical）如何分工？
股票评级变动（/stable/grades，必填 symbol）重在输出 gradingCompany（评级机构）与 previousGrade 等 6 列；而 Historical Stock Grades（历史评级记录）返回 7 列，两者按查询维度互补。
在批量同步股票评级变动时，/stable/grades 的查询窗口与参数组合该如何安排？
推荐做法：向 /stable/grades 传入标准 symbol（港股带 .HK、A 股带 .SS）；当 /stable/grades 正常返回含 gradingCompany 的 JSON/CSV 后，即可直接合入本地策略宽表。
同模块相关接口对比
Upgrades Downgrades本接口路径 /stable/grades，必填参数 symbol。 同一模块「Upgrades Downgrades」下共 3 个接口，下表列出其余 2 个， 按粒度与查询维度对比，避免选错接口。