Financial Scores财务健康评分
该接口通过 Altman Z-Score(Z 值评分)、Piotroski 评分、营运资本等关键指标评估公司的财务实力与稳定性,提示破产风险。
https://quote-fmp.com/stable/financial-scores?symbol=AAPL数据更新周期
Filing Date · 随 SEC 申报日期更新
接口说明
- 破产风险分析:用 Altman Z-Score(Z 值评分)评估公司陷入财务困境的可能性,传入
symbol后可下发altmanZScore(AltmanZ值(破产预警))、piotroskiScore(PiotroskiF评分(0~9))与workingCapital(营运资本) 等标准化字段,可无缝接入实盘风控与预警系统。 - 盈利与效率评估:Piotroski 评分通过衡量盈利能力和经营效率,判断公司的财务实力,配合
piotroskiScore(PiotroskiF评分(0~9))与workingCapital(营运资本) 等返回项,能高效支撑同行业标的横向比对。 - 营运资本管理:跟踪营运资本的变化,了解公司对短期资产与负债的管理,实务中常与同模块的「股东盈余(Owner Earnings)」联合调用,先做广度筛查再下钻单标明细。
- 关联数据线接口:As Reported Balance Statements(原始申报资产负债表) · As Reported Cashflow Statements(原始申报现金流量表) · Stock Price and Volume Data(日线完整行情) · Financial Estimates(分析师预期查询)
请求参数
1 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
symbol | string | 必填 | AAPL | 证券代码,例如 AAPL 或 MSFT(美股直传代码如 AAPL;港股/英股/A股须带交易所后缀,如 0700.HK、600519.SS) |
调用代码示例
Python 关键代码在 Python 中调用 财务健康评分(/stable/financial-scores,必填 symbol),可提取 altmanZScore(Altman Z 值(破产预警))、piotroskiScore(Piotroski F 评分(0~9))、workingCapital(营运资本)(altmanZScore=14.041374927993303)。
resp = requests.get(
"https://quote-fmp.com/stable/financial-scores",
params={"symbol": "AAPL", "apikey": FMP_KEY},
timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 数值化核心指标列 altmanZScore(Altman Z 值(破产预警))
df["altmanZScore"] = pd.to_numeric(df["altmanZScore"], errors="coerce")参数使用和避坑
2 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法:
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 获取 AAPL 最新财务健康评分记录 | symbol=AAPL | 通过 symbol=AAPL 访问 /stable/financial-scores,一次拿齐 财务健康评分 的 altmanZScore、piotroskiScore、workingCapital 等核心列。 |
| 带 .HK 后缀查询港股标的财务健康评分 | symbol=0700.HK | 针对非美股标的传入 0700.HK,从 /stable/financial-scores 提取对应的 altmanZScore、piotroskiScore、workingCapital。 |
使用 /stable/financial-scores 同步财务健康评分(必填 symbol)时,altmanZScore(Altman Z 值(破产预警))为关键业务列;多次拉取或增量合并时请按主键去重。
对财务健康评分(/stable/financial-scores)执行增量 ETL 时,通过 (symbol) 唯一约束幂等写入,并将 altmanZScore(Altman Z 值(破产预警))与 piotroskiScore(Piotroski F 评分(0~9)) 统一转为浮点列。
返回数据
11 个字段本接口示例响应共包含 11 个字段(数值型 9 个,文本/日期/布尔型 2 个)。下表列出全部字段名、类型、首条记录真实样本值与中文释义,实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
symbol | string | "AAPL" | 证券代码 |
reportedCurrency | string | "USD" | 报告币种(原始财报计价币种;跨国公司对比或与美元市值相除前须先按汇率折算) |
altmanZScore | number | 14.041374927993303 | Altman Z 值(破产预警) |
piotroskiScore | number | 9 | Piotroski F 评分(0~9) |
workingCapital | number | 9473000000 | 营运资本 |
totalAssets | number | 371082000000 | 资产总计 |
retainedEarnings | number | 12359000000 | 留存收益 |
ebit | number | 147722000000 | 息税前利润(EBIT) |
marketCap | number | 5042169135511 | 总市值 |
totalLiabilities | number | 264591000000 | 负债合计 |
revenue | number | 451442000000 | 营业收入 |
查看响应数据示例(原始 JSON)
[
{
"symbol": "AAPL",
"reportedCurrency": "USD",
"altmanZScore": 14.041374927993303,
"piotroskiScore": 9,
"workingCapital": 9473000000,
"totalAssets": 371082000000,
"retainedEarnings": 12359000000,
"ebit": 147722000000,
"marketCap": 5042169135511,
"totalLiabilities": 264591000000,
"revenue": 451442000000
}
]计算口径对照:本接口涉及的9 项 Piotroski 财务健康打分规则与 Altman Z 破产预警模型公式,可查看 Piotroski F-Score 与 Altman Z 计算公式 →
常见问题解答(FAQ)
2 个问题投研选型时,什么场景用财务健康评分(/stable/financial-scores),什么场景改用 股东盈余(Owner Earnings)?
当您需要 altmanZScore(Altman Z 值(破产预警),如 14.041374927993303)与 piotroskiScore(Piotroski F 评分(0~9))时调 财务健康评分(/stable/financial-scores,必填 symbol);反之若侧重 Owner Earnings(股东盈余(Owner Earnings)) 的维度,则请求 /stable/owner-earnings(必填 symbol)。
在脚本里循环或定时请求 /stable/financial-scores(财务健康评分)时,有哪些调度细节要注意?
在脚本编排上,建议传入目标证券 symbol 访问 /stable/financial-scores 采集单票数据;将每次从 /stable/financial-scores 拿到的 altmanZScore(Altman Z 值(破产预警))按批次追加至本地历史表。
同模块相关接口对比
Analysis本接口路径 /stable/financial-scores,必填参数 symbol。 同一模块「Analysis」下共 3 个接口,下表列出其余 2 个, 按粒度与查询维度对比,避免选错接口。
| 接口 | 路径 | 核心差异与适用场景 |
|---|---|---|
| 股东盈余(Owner Earnings)Owner Earnings | /stable/owner-earnings | 巴菲特口径的股东盈余序列,以经营现金流扣减维持性资本开支并调整营运资本变动 |
| 企业价值查询Enterprise Values | /stable/enterprise-values | 公司企业价值(EV)及其构成,市值、总债务与现金及现金等价物,兼顾股权与债务的公司总价值 |