Owner Earnings股东盈余(Owner Earnings)
该接口返回巴菲特口径的股东盈余(Owner Earnings)序列,以经营现金流扣减维持性资本开支(Maintenance CapEx)并调整营运资本变动,衡量企业可自由分配给股东的真实造血能力。
https://quote-fmp.com/stable/owner-earnings?symbol=AAPL数据更新周期
Filing Date · 随 SEC 申报日期更新
接口说明
- 投资者评估:计算真正可供股东使用的现金,比净利润更清晰地反映盈利能力,传入
symbol后可覆盖averagePPE(平均固定资产(PP&E))、maintenanceCapex(维持性资本开支)与ownersEarnings(股东盈余) 等高频字段,适合定时批量归档至本地数据库。 - 估值分析:评估企业真实内生现金创造能力,支撑跨财年基本面趋势拆解与杜邦盈利归因,围绕
maintenanceCapex(维持性资本开支)与ownersEarnings(股东盈余) 等字段,可在回测中还原历史任意时点的真实截面。 - 资本开支洞察:了解维持性与增长性资本开支(Capex)的拆分,评估公司收入中有多大部分被再投资,若需补充上下文维度,可搭配同模块的「企业价值查询」交叉比对核心指标。
- 关联数据线接口:As Reported Balance Statements(原始申报资产负债表) · As Reported Cashflow Statements(原始申报现金流量表) · Stock Price and Volume Data(日线完整行情) · Financial Estimates(分析师预期查询)
请求参数
2 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
symbol | string | 必填 | AAPL | 证券代码,例如 AAPL 或 MSFT(美股直传代码如 AAPL;港股/英股/A股须带交易所后缀,如 0700.HK、600519.SS) |
limit | number | 可选 | 5 | 返回结果条数上限,用于控制单次响应大小。 |
调用代码示例
Python 关键代码在 Python 中调用 股东盈余(Owner Earnings)(/stable/owner-earnings,必填 symbol),可提取 averagePPE(平均固定资产(PP&E))、maintenanceCapex(维持性资本开支)、ownersEarnings(股东盈余)(averagePPE=0.13466)。
resp = requests.get(
"https://quote-fmp.com/stable/owner-earnings",
params={"symbol": "AAPL", "limit": 5, "apikey": FMP_KEY},
timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 按 date 升序重排并数值化 averagePPE(平均固定资产(PP&E))
df["averagePPE"] = pd.to_numeric(df["averagePPE"], errors="coerce")
df = df.sort_values("date").reset_index(drop=True)参数使用和避坑
3 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法:
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 获取 AAPL 最新股东盈余(Owner Earnings)记录 | symbol=AAPL | 通过 symbol=AAPL 访问 /stable/owner-earnings,一次拿齐 股东盈余(Owner Earnings) 的 averagePPE、maintenanceCapex、ownersEarnings 等核心列。 |
| 批量回填 AAPL 近 100 期股东盈余(Owner Earnings)记录 | symbol=AAPL&limit=100 | 配合 limit=100 调用 /stable/owner-earnings,单次拿齐 AAPL 更长窗口的历史 averagePPE、maintenanceCapex、ownersEarnings 序列。 |
| 带 .HK 后缀查询港股标的股东盈余(Owner Earnings) | symbol=0700.HK | 针对非美股标的传入 0700.HK,从 /stable/owner-earnings 提取对应的 averagePPE、maintenanceCapex、ownersEarnings。 |
使用 /stable/owner-earnings 同步股东盈余(Owner Earnings)(必填 symbol)时,averagePPE(平均固定资产(PP&E))与 maintenanceCapex(维持性资本开支)为关键业务列;多次拉取或增量合并时请在边界处按主键去重。
对股东盈余(Owner Earnings)(/stable/owner-earnings)执行增量 ETL 时,通过 (symbol, date, fiscalYear) 唯一约束幂等写入,并将 averagePPE(平均固定资产(PP&E))与 maintenanceCapex(维持性资本开支) 统一转为浮点列。
返回数据
10 个字段本接口示例响应共包含 10 个字段(数值型 5 个,文本/日期/布尔型 5 个)。下表列出全部字段名、类型、首条记录真实样本值与中文释义,实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
symbol | string | "AAPL" | 证券代码 |
reportedCurrency | string | "USD" | 报告币种(原始财报计价币种;跨国公司对比或与美元市值相除前须先按汇率折算) |
fiscalYear | string | "2026" | 财政年度 |
period | string | "Q2" | 报告周期 |
date | string | "2026-03-28" | 日期 |
averagePPE | number | 0.13466 | 平均固定资产(PP&E) |
maintenanceCapex | number | 159994500 | 维持性资本开支 |
ownersEarnings | number | 28861994500 | 股东盈余 |
growthCapex | number | -2130994500 | 增长性资本开支 |
ownersEarningsPerShare | number | 1.95 | 每股股东盈余 |
查看响应数据示例(原始 JSON)
[
{
"symbol": "AAPL",
"reportedCurrency": "USD",
"fiscalYear": "2026",
"period": "Q2",
"date": "2026-03-28",
"averagePPE": 0.13466,
"maintenanceCapex": 159994500,
"ownersEarnings": 28861994500,
"growthCapex": -2130994500,
"ownersEarningsPerShare": 1.95
}
]计算口径对照:本接口涉及的经营现金流扣除维持性资本开支与营运资本调整的完整计算公式,可查看 巴菲特股东盈余(Owner's Earnings)公式 →
常见问题解答(FAQ)
2 个问题投研选型时,什么场景用股东盈余(Owner Earnings)(/stable/owner-earnings),什么场景改用 财务健康评分?
当您需要 averagePPE(平均固定资产(PP&E),如 0.13466)与 maintenanceCapex(维持性资本开支)时调 股东盈余(Owner Earnings)(/stable/owner-earnings,必填 symbol);反之若侧重 Financial Scores(财务健康评分) 的维度,则请求 /stable/financial-scores(必填 symbol)。
在脚本里循环或定时请求 /stable/owner-earnings(股东盈余(Owner Earnings))时,有哪些调度细节要注意?
在脚本编排上,建议根据回测跨度需求在 /stable/owner-earnings 中设置 limit 条数上限一次拿齐序列;将每次从 /stable/owner-earnings 拿到的 averagePPE(平均固定资产(PP&E))按批次追加至本地历史表。
同模块相关接口对比
Analysis本接口路径 /stable/owner-earnings,必填参数 symbol。 同一模块「Analysis」下共 3 个接口,下表列出其余 2 个, 按粒度与查询维度对比,避免选错接口。