Historical Ratings历史财务评分
该接口按时间序列返回指定股票在过往各交易日的历史综合财务评级与六大基本面子项得分(DCF、ROE、ROA、资产负债率、P/E、P/B)。它完整记录了公司财务健康度与估值性价比随时间演变的轨迹,直接支撑基本面评分因子的历史回测。
https://quote-fmp.com/stable/ratings-historical?symbol=AAPL数据更新周期
6 Hours
接口说明
- 无前视偏差基本面评分回测:若仅使用最新静态评级做历史选股回测,会产生严重的未来函数偏差。该接口按历史日期保留了当时时点的综合评级字母、总得分及六项细分指标打分,确保回测引擎在任意历史截面均能读取到真实的当期评估值。
- 追踪财务质量跃迁与动态拐点:通过拉取连续多期历史评分序列,投研人员可清晰观测一家公司是如何从高负债、低回报的弱势评级(如 D 或 C 级)逐步改善资产负债表与盈利能力、跃迁至优质评级(A 或 S 级)的全过程,捕捉基本面戴维斯双击信号。
- 多维度子项得分拆解与归因分析:当个股综合评分发生显著上调或下调时,可通过对比历史序列中盈利能力分(ROE/ROA)、杠杆安全分(D/E)与估值分(P/E、P/B、DCF)的变动轨迹,精准判定评级异动是由业绩基本面改善驱动,还是单纯由股价下跌带来的估值被动抬升。
- 关联数据线接口:Stock Grades(股票评级变动) · Historical Stock Grades(历史评级记录) · Ratings Summary by Symbol(个股评级汇总) · Stock Quote(股票报价)
请求参数
2 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
symbol | string | 必填 | AAPL | 证券代码,例如 AAPL 或 MSFT(美股直传代码如 AAPL;港股/英股/A股须带交易所后缀,如 0700.HK、600519.SS) |
limit | number | 可选 | 1 | 返回结果条数上限,用于控制单次响应大小。 |
调用代码示例
Python 关键代码执行 /stable/ratings-historical 查询历史财务评分(必填 symbol),直接产出 rating(评级)、overallScore(综合评分)、discountedCashFlowScore(现金流折现得分) 等 10 项字段。
resp = requests.get(
"https://quote-fmp.com/stable/ratings-historical",
params={"symbol": "AAPL", "limit": 1, "apikey": FMP_KEY},
timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 按 date 升序重排并数值化 overallScore(综合评分)
df["overallScore"] = pd.to_numeric(df["overallScore"], errors="coerce")
df = df.sort_values("date").reset_index(drop=True)参数使用和避坑
3 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法:
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 获取 AAPL 最新历史财务评分记录 | symbol=AAPL | 通过 symbol=AAPL 访问 /stable/ratings-historical,一次拿齐 历史财务评分 的 rating、overallScore、discountedCashFlowScore 等核心列。 |
| 扩大返回条数上限拉取 AAPL 历史历史财务评分 | symbol=AAPL&limit=100 | 向 /stable/ratings-historical 传入 limit=100,一次性获取 AAPL 多期历史 rating、overallScore、discountedCashFlowScore(共 10 列)。 |
| 带 .HK 后缀查询港股标的历史财务评分 | symbol=0700.HK | 针对非美股标的传入 0700.HK,从 /stable/ratings-historical 提取对应的 rating、overallScore、discountedCashFlowScore。 |
历史财务评分(路径 /stable/ratings-historical,必填 symbol)输出 rating(评级)及 overallScore(综合评分);在做多标的横截面合并时,请确保各标的在同一时间截面上对齐。
在为历史财务评分(/stable/ratings-historical)设计表结构时,以 (symbol, date) 唯一锁定记录,并对 overallScore(综合评分)与 discountedCashFlowScore(现金流折现得分) 保留完整浮点精度。
返回数据
10 个字段本接口示例响应共包含 10 个字段(数值型 7 个,文本/日期/布尔型 3 个)。下表列出全部字段名、类型、首条记录真实样本值与中文释义,实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
symbol | string | "AAPL" | 证券代码 |
date | string | "2026-07-30" | 日期 |
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",
"date": "2026-07-30",
"rating": "B",
"overallScore": 3,
"discountedCashFlowScore": 3,
"returnOnEquityScore": 5,
"returnOnAssetsScore": 5,
"debtToEquityScore": 1,
"priceToEarningsScore": 2,
"priceToBookScore": 1
}
]计算口径对照:本接口涉及的历史评级序列底层六大财务维度打分规则与等级映射公式,可查看 公司 13 档综合评级计算公式 →
常见问题解答(FAQ)
2 个问题在「Ratings」分类下,历史财务评分(10 个字段)与 评级快照 的核心差异点是什么?
历史财务评分 与 Ratings Snapshot(评级快照) 分别映射 /stable/ratings-historical(必填 symbol,含 rating 等 10 列)与 /stable/ratings-snapshot(必填 symbol,含 9 列),可按研究粒度灵活选用。
实盘任务调用 /stable/ratings-historical 拉取历史财务评分时,如何规范化控制查询边界与重试节奏?
您只需根据回测跨度需求在 /stable/ratings-historical 中设置 limit 条数上限一次拿齐序列;配合空数组 [] 短路判断,即可构建零人工干预的 历史财务评分(rating)自动化同步任务。
同模块相关接口对比
Ratings本接口路径 /stable/ratings-historical,必填参数 symbol。 同一模块「Ratings」下共 2 个接口,下表列出其余 1 个, 按粒度与查询维度对比,避免选错接口。
| 接口 | 路径 | 核心差异与适用场景 |
|---|---|---|
| 评级快照Ratings Snapshot | /stable/ratings-snapshot | 单只股票基于多维财务基本面量化模型计算的最新综合评级快照及总得分 |