Stock Rating Bulk评级批量
该接口以单次 CSV 流式响应批量导出全市场股票的综合财务评级快照（Rating Bulk），包含总评级得分及 DCF、ROE、ROA、负债率、PE、PB 各分项打分。
https://quote-fmp.com/stable/rating-bulk数据更新周期
4-6 Hours
接口说明
- 获取全面评级：基于 DCF、ROE、ROA、市盈率(PE)等多项金融指标获取评级，调用后可获取
rating（评级）、discountedCashFlowScore（现金流折现得分）与returnOnEquityScore（净资产收益率得分） 等核心要素，减少跨市场数据入库时的字段映射工作。 - 批量请求：一次 API 调用获取多只股票的评级数据，提高数据获取效率，通过单次 CSV 流式响应完成全市场数万标的截面同步。
- 辅助投资决策：基于全面的财务分析，若需补充上下文维度，可搭配同模块的「DCF 批量估值」交叉比对核心指标。
- CSV 文本流格式：
/stable/rating-bulk直接下发带表头的 CSV 文本流而非 JSON 数组，请使用pd.read_csv(io.StringIO(resp.text))流式读取。 - 配套投研接口：Income Statement Bulk（利润表批量获取） · Income Statement Growth Bulk（利润表增长批量获取） · Key Metrics TTM（TTM 关键指标） · Stock Price and Volume Data（日线完整行情）
调用代码示例
Python 关键代码评级批量（/stable/rating-bulk）直接下发 CSV 文本流，须用 pd.read_csv(io.StringIO(resp.text)) 读取 rating（评级）、discountedCashFlowScore（现金流折现得分）、returnOnEquityScore（净资产收益率得分） 等 9 列。
import io
resp = requests.get(
"https://quote-fmp.com/stable/rating-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["discountedCashFlowScore"] = pd.to_numeric(df["discountedCashFlowScore"], errors="coerce")参数使用和避坑
3 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法：
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 一次性拉取全量评级批量初始化本地主表 | GET /stable/rating-bulk（免参数） | 直接请求 /stable/rating-bulk 即返回全表，含 rating、discountedCashFlowScore、returnOnEquityScore 等 9 列；建库或每日全量覆盖时无需拼接任何 Query 参数。 |
| 以 symbol 为唯一键覆盖写入，避免全表重复 | GET /stable/rating-bulk → upsert on symbol | 全表每轮返回 symbol（样本 000001.SZ）等 9 列，落库时以 symbol 作唯一键覆盖；同模块无参数相近的接口，单点补数只能重拉全表。 |
| 落库后自检：symbol 唯一性与 rating 空值率 | GET /stable/rating-bulk → count(distinct symbol) / null_ratio(rating) | 本表共 9 列。落库后先比对 count(distinct symbol) 与总行数确认无重复；再统计 rating（样本 B+）的空值比例，判断该批次是否拉到完整截面。 |
同步评级批量（/stable/rating-bulk）时响应体为带表头的 CSV 文本，包含 rating（评级）与 discountedCashFlowScore（现金流折现得分）等 9 列，请用 pd.read_csv 流式读取。
处理 /stable/rating-bulk 下发的评级批量记录时，以 (symbol, date) 作为 Upsert 冲突键，同时核对 discountedCashFlowScore（5）的数值单位。
返回数据
9 个字段本接口示例响应共包含 9 个字段（数值型 0 个，文本/日期/布尔型 9 个）。下表列出全部字段名、类型、首条记录真实样本值与中文释义，实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
symbol | string | "000001.SZ" | 证券代码 |
date | string | "2025-07-09" | 日期 |
rating | string | "B+" | 评级 |
discountedCashFlowScore | string | "5" | 现金流折现得分 |
returnOnEquityScore | string | "3" | 净资产收益率得分 |
returnOnAssetsScore | string | "2" | 总资产收益率得分 |
debtToEquityScore | string | "1" | 产权比率得分 |
priceToEarningsScore | string | "4" | 市盈率得分 |
priceToBookScore | string | "4" | 市净率得分 |
查看响应数据示例（原始 JSON）
[
{
"symbol": "000001.SZ",
"date": "2025-07-09",
"rating": "B+",
"discountedCashFlowScore": "5",
"returnOnEquityScore": "3",
"returnOnAssetsScore": "2",
"debtToEquityScore": "1",
"priceToEarningsScore": "4",
"priceToBookScore": "4"
}
]常见问题解答（FAQ）
2 个问题评级批量和 公司概况批量 属于同一模块，两者的查询键与核心产出字段如何区分？
区分方式很简单：需要 rating（评级）和 discountedCashFlowScore（现金流折现得分）这 9 项字段时请求 /stable/rating-bulk（免业务参数）；需要 Company Profile Bulk（公司概况批量） 的 36 项字段时请求 /stable/profile-bulk（必填 part）。
在设计评级批量（/stable/rating-bulk）的数据拉取管道时，怎样避免单次请求跨度过大或遗漏？
实盘中推荐直接请求无参端点 /stable/rating-bulk 拉取全表快照并缓存；通过规范化参数边界，可让 /stable/rating-bulk 稳定产出 rating（评级）等核心业务指标。
同模块相关接口对比
Profile本接口路径 /stable/rating-bulk，无必填参数。 同一模块「Profile」下共 11 个接口，下表列出其余 10 个， 按粒度与查询维度对比，避免选错接口。
| 接口 | 路径 | 核心差异与适用场景 |
|---|---|---|
| 公司概况批量Company Profile Bulk | /stable/profile-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 持仓资产的详细清单，每项资产的持股数量、权重占比、市值 |
| 评级共识批量数据Upgrades Downgrades Consensus Bulk | /stable/upgrades-downgrades-consensus-bulk | 批量获取全部股票代码的分析师评级总览，一次请求即可拿到分析师上调评级、下调评级与共识推荐 |
| 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 对比 |