Financial Scores Bulk财务评分批量

Q: 工程团队在封装 /stable/scores-bulk（财务评分批量）客户端时，应采用怎样的拉取逻辑？

标准流程是直接请求无参端点 /stable/scores-bulk 拉取全表快照并缓存；在拿到 财务评分批量 的 altmanZScore 与 piotroskiScore 后，及时释放内存中的原始文本流。

该接口以单次 CSV 流式响应批量返回全市场股票的 Piotroski F-Score（财务健康度 0–9 分）与 Altman Z-Score（破产风险预警）截面，用于全市场基本面排雷。

GEThttps://quote-fmp.com/stable/scores-bulk

数据更新周期

4-6 Hours

接口说明

Altman Z 值评分：用这一关键偿债能力指标评估公司的破产可能性，调用后可拿到 altmanZScore（AltmanZ值（破产预警））、piotroskiScore（PiotroskiF评分（0~9））与 workingCapital（营运资本）等明细项，便于在 Python 或 SQL 中直接聚合。
Piotroski 财务健康度评分：基于九项标准评估公司的财务实力与表现，通过单次 CSV 流式响应完成全市场数万标的截面同步。
营运资本与总资产：洞察公司短期财务健康状况与资产规模，工程落库阶段可与「目标价汇总批量」共用主键索引，形成完整的专题数据集。
CSV 文本流格式：/stable/scores-bulk 直接下发带表头的 CSV 文本流而非 JSON 数组，请使用 pd.read_csv(io.StringIO(resp.text)) 流式读取。
上下游关联接口：Eod Bulk（日线行情批量） · Income Statement Bulk（利润表批量获取） · Income Statement（利润表） · Key Metrics TTM（TTM 关键指标）

调用代码示例

Python 关键代码

财务评分批量（/stable/scores-bulk）直接下发 CSV 文本流，须用 pd.read_csv(io.StringIO(resp.text)) 读取 altmanZScore（Altman Z 值（破产预警））、piotroskiScore（Piotroski F 评分（0~9））、workingCapital（营运资本）等 11 列。

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

import io
resp = requests.get(
    "https://quote-fmp.com/stable/scores-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["altmanZScore"] = pd.to_numeric(df["altmanZScore"], errors="coerce")

参数使用和避坑

3 组参数组合 · 2 条避坑

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

投研场景	Query 参数组合示例	返回数据特征与用途
一次性拉取全量财务评分批量初始化本地主表	`GET /stable/scores-bulk（免参数）`	该接口不吃 Query 条件：请求 /stable/scores-bulk 直接下发全表 11 列，altmanZScore、piotroskiScore、workingCapital 全在其中。
以 symbol 为唯一键覆盖写入，避免全表重复	`GET /stable/scores-bulk → upsert on symbol`	落库键选 symbol（如 000001.SZ），11 列逐行覆盖；同模块没有带参接口，想补单条只能再拉一次全表。
落库后自检：symbol 唯一性与 altmanZScore 空值率	`GET /stable/scores-bulk → count(distinct symbol) / null_ratio(altmanZScore)`	本表共 11 列。落库后先比对 count(distinct symbol) 与总行数确认无重复；再统计 altmanZScore（样本 0.29153682196643543）的空值比例，判断该批次是否拉到完整截面。

CSV 流式解析财务评分批量：/stable/scores-bulk 下发 CSV 文本流，切勿调 resp.json()

同步财务评分批量（/stable/scores-bulk）时响应体为带表头的 CSV 文本，包含 altmanZScore（Altman Z 值（破产预警））与 piotroskiScore（Piotroski F 评分（0~9））等 11 列，请用 pd.read_csv 流式读取。

落库主键与口径对接 /stable/scores-bulk：以 (symbol) 防重并提取 altmanZScore（Altman Z 值（破产预警））

/stable/scores-bulk 的首条样本含 altmanZScore=0.29153682196643543；日常增量任务按 (symbol) 合并即可保持本地库与上游一致。

返回数据

11 个字段

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

字段	类型	示例值	说明
`symbol`	string	`"000001.SZ"`	证券代码
`reportedCurrency`	string	`"CNY"`	报告币种（原始财报计价币种；跨国公司对比或与美元市值相除前须先按汇率折算）
`altmanZScore`	string	`"0.29153682196643543"`	Altman Z 值（破产预警）
`piotroskiScore`	string	`"5"`	Piotroski F 评分（0~9）
`workingCapital`	string	`"746131000000"`	营运资本
`totalAssets`	string	`"5777858000000"`	资产总计
`retainedEarnings`	string	`"255621000000"`	留存收益
`ebit`	string	`"32590000000"`	息税前利润（EBIT）
`marketCap`	string	`"236751980000"`	总市值
`totalLiabilities`	string	`"5271746000000"`	负债合计
`revenue`	string	`"167996000000"`	营业收入

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

[
{
"symbol": "000001.SZ",
"reportedCurrency": "CNY",
"altmanZScore": "0.29153682196643543",
"piotroskiScore": "5",
"workingCapital": "746131000000",
"totalAssets": "5777858000000",
"retainedEarnings": "255621000000",
"ebit": "32590000000",
"marketCap": "236751980000",
"totalLiabilities": "5271746000000",
"revenue": "167996000000"
}
]

常见问题解答（FAQ）

2 个问题

财务评分批量（/stable/scores-bulk）产出的 altmanZScore 等字段，与公司概况批量的返回内容有何侧重？

财务评分批量（端点 /stable/scores-bulk，免业务参数）返回 altmanZScore（Altman Z 值（破产预警））及 piotroskiScore（5）共 11 列；若业务需要 Company Profile Bulk（公司概况批量），可改调 /stable/profile-bulk（必填 part）。

工程团队在封装 /stable/scores-bulk（财务评分批量）客户端时，应采用怎样的拉取逻辑？

标准流程是直接请求无参端点 /stable/scores-bulk 拉取全表快照并缓存；在拿到财务评分批量的 altmanZScore 与 piotroskiScore 后，及时释放内存中的原始文本流。

同模块相关接口对比

Profile

本接口路径 /stable/scores-bulk，无必填参数。同一模块「Profile」下共 11 个接口，下表列出其余 10 个，按粒度与查询维度对比，避免选错接口。

接口	路径	核心差异与适用场景
公司概况批量Company Profile Bulk	`/stable/profile-bulk`	以 CSV 流式分片形式一次性返回全市场上市公司的档案主表
评级批量Stock Rating Bulk	`/stable/rating-bulk`	以单次 CSV 流式响应批量导出全市场股票的综合财务评级快照
DCF 批量估值DCF Valuations Bulk	`/stable/dcf-bulk`	一次请求即可返回多个代码的现金流折现（DCF）估值，含隐含价格变动空间与百分比差异
目标价汇总批量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 对比

Bulk（批量数据）全部接口目录 →

需要稳定访问财务评分批量数据？注册即可获取专属 API Key，免费体验全部接口。

免费试用 1 个月