Ratings Snapshot评级快照

该接口返回单只股票基于多维财务基本面量化模型计算的最新综合评级快照（如 S、A+ 至 C、D 等档位）及总得分。它将现金流折现、ROE、ROA、资产负债率及市盈率、市净率六个维度的单项打分浓缩为直观的健康度诊断卡片。

GEThttps://quote-fmp.com/stable/ratings-snapshot?symbol=AAPL

数据更新周期

6 Hours

接口说明

六维基本面健康度标准化评分：接口将复杂的财务报表与估值指标提炼为现金流折现（DCF）、净资产收益率（ROE）、总资产收益率（ROA）、负债权益比（D/E）、市盈率（P/E）和市净率（P/B）六大子项评分（1 至 5 分），协助投研人员在数秒内识别公司的基本面长板与财务短板。
量化初筛与终端可视化评分组件：对于行情终端与投研看板研发而言，无需自行编写复杂的多指标分位数打分算法，直接调用该快照即可在个股主页渲染标准化的“基本面综合评级徽章”与六维雷达图，直观展示盈利能力、偿债安全与估值性价比。
最新截面评估与候选池快速过滤：该接口专注于低延迟返回最新时点的静态评估结果；在实盘选股流水线中，可先用其快速验证候选标的当前是否处于高评级区间（如总分 4 分以上），再结合历史评级序列观察其评分是否处于上升通道。
上下游关联接口：Financial Estimates（分析师预期查询） · Price Target Summary（目标价汇总） · Earnings Transcript（业绩电话会纪要检索） · Ratings Summary by Symbol（个股评级汇总）

请求参数

1 个参数

参数	类型	要求	示例	说明
`symbol`	string	必填	`AAPL`	证券代码，例如 AAPL 或 MSFT（美股直传代码如 AAPL；港股/英股/A股须带交易所后缀，如 0700.HK、600519.SS）

调用代码示例

Python 关键代码

从 /stable/ratings-snapshot 同步评级快照（必填 symbol），一次拿齐 rating（评级）、overallScore（综合评分）、discountedCashFlowScore（现金流折现得分）（样本值 rating=B）。

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

resp = requests.get(
    "https://quote-fmp.com/stable/ratings-snapshot",
    params={"symbol": "AAPL", "apikey": FMP_KEY},
    timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 数值化核心指标列 overallScore（综合评分）
df["overallScore"] = pd.to_numeric(df["overallScore"], errors="coerce")

参数使用和避坑

2 组参数组合 · 2 条避坑

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

投研场景	Query 参数组合示例	返回数据特征与用途
定向上游请求 AAPL 评级快照（symbol=AAPL）	`symbol=AAPL`	请求 /stable/ratings-snapshot?symbol=AAPL，产出该标的的 rating、overallScore、discountedCashFlowScore（样本 B）等 9 列明细。
跨市场检索 0700.HK 的评级快照数据	`symbol=0700.HK`	通过 symbol=0700.HK 请求 /stable/ratings-snapshot，实现评级快照在港股市场的同口径采集（含 rating、overallScore、discountedCashFlowScore）。

参数与空值防守评级快照首行校验：rating=B 与空数组拦截

针对 /stable/ratings-snapshot（评级快照，必填 symbol），返回首行的 rating 为 B；入库前请先拦截 200 [] 空响应。

落库主键与口径评级快照数据表设计：(symbol) 唯一键与 overallScore 原始量纲

持久化 /stable/ratings-snapshot（评级快照）的 9 个字段时，自然键取 (symbol)；数值列 overallScore（样本 3）切勿用整型截断小数精度。

返回数据

9 个字段

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

字段	类型	示例值	说明
`symbol`	string	`"AAPL"`	证券代码
`rating`	string	`"B"`	评级
`overallScore`	number	`3`	综合评分
`discountedCashFlowScore`	number	`3`	现金流折现得分
`returnOnEquityScore`	number	`5`	净资产收益率得分
`returnOnAssetsScore`	number	`5`	总资产收益率得分
`debtToEquityScore`	number	`1`	产权比率得分
`priceToEarningsScore`	number	`2`	市盈率得分
`priceToBookScore`	number	`1`	市净率得分

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

[
{
"symbol": "AAPL",
"rating": "B",
"overallScore": 3,
"discountedCashFlowScore": 3,
"returnOnEquityScore": 5,
"returnOnAssetsScore": 5,
"debtToEquityScore": 1,
"priceToEarningsScore": 2,
"priceToBookScore": 1
}
]

计算口径对照：本接口涉及的DCF、ROE、ROA、D/E、P/E、P/B 六维度打分与 S+ 至 F 评级映射表，可查看公司 13 档综合评级计算公式 →

常见问题解答（FAQ）

2 个问题

在「Ratings」下，评级快照（/stable/ratings-snapshot）与历史财务评分（/stable/ratings-historical）如何分工？

评级快照（/stable/ratings-snapshot，必填 symbol）重在输出 rating（评级）与 overallScore 等 9 列；而 Historical Ratings（历史财务评分）返回 10 列，两者按查询维度互补。

在批量同步评级快照时，/stable/ratings-snapshot 的查询窗口与参数组合该如何安排？

推荐做法：向 /stable/ratings-snapshot 传入标准 symbol（港股带 .HK、A 股带 .SS）；当 /stable/ratings-snapshot 正常返回含 rating 的 JSON/CSV 后，即可直接合入本地策略宽表。

同模块相关接口对比

Ratings

本接口路径 /stable/ratings-snapshot，必填参数 symbol。同一模块「Ratings」下共 2 个接口，下表列出其余 1 个，按粒度与查询维度对比，避免选错接口。

接口	路径	核心差异与适用场景
历史财务评分Historical Ratings	`/stable/ratings-historical`	按时间序列返回指定股票在过往各交易日的历史综合财务评级与六大基本面子项得分

Analyst（分析师数据）全部接口目录 →

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

免费试用 1 个月