组合增长率、盈利能力、资本结构与估值指标筛选公司。
Statements(财务报表)
此类接口提供上市公司财务报表信息,包括利润表、资产负债表、现金流量表,TTM 滚动口径与同比增长率,财务比率与关键指标,财务评分、Owner Earnings 与企业价值,以及收入的产品分部与地域分部。字段经过标准化映射,方便跨公司横向比较;要对回公司原始披露时,走 As Reported 与 10-K 文件。
典型使用场景
4 个场景按季度跟踪营收、利润、现金流和资产负债变化。
使用标准化报表与比率建立可比较的研究表。
将标准字段回溯到公司原始报告口径。
细分专题
按数据口径选择接口怎么选?
6 项选型对照财务数据接口数量多,但选择逻辑可以归纳为三步:先选标准报表、财务指标或原始披露,再选年度、季度或 TTM,最后决定单公司查询还是后续的批量下载。
标准化数据适合跨公司比较;As Reported 更接近公司原始披露字段。非美股市场的财报完整度、币种和历史范围应按标的验证。
| 你的需求 | 推荐接口 | 选择理由 |
|---|---|---|
| 查询一家公司的标准利润表 | Income Statement利润表 | 最常用的营收、利润和 EPS 入口 |
| 获取最近一期完整三大报表 | Latest Financial Statements最新财务报表 | 无需预先确定报告期 |
| 获取 ROE、毛利率和估值比率 | Financial Ratios财务比率 | 直接返回已经计算的财务比率 |
| 获取滚动十二个月指标 | Key Metrics TTMTTM 关键指标 | 适合滚动估值和跨报告期比较 |
| 分析营收、利润和现金流增长 | Financial Statement Growth报表增长分析 | 直接返回报表同比增长数据 |
| 核对公司原始披露字段 | As Reported Financial Statements原始申报财务报表 | 保留原始报告口径,适合审计和映射 |
数据覆盖与参数口径
- 适用资产:上市公司股票
- 主要市场:美股及部分全球交易所;已验证样例不等于全市场完整覆盖
- 报告周期:年度、季度、TTM,具体取决于接口
- 数据币种:以返回字段 reportedCurrency 为准
- 更新时间:通常随公司财务报告披露更新
- 历史范围:因标的、上市年限和套餐而异
调用示例
Python 关键代码示例场景:获取 AAPL 最近五期季度利润表 · 对应接口:Income Statement(利润表)
resp = requests.get(
"https://quote-fmp.com/stable/income-statement",
params={"symbol": "AAPL", "period": "quarter", "limit": 12, "apikey": FMP_KEY},
)
df = pd.DataFrame(resp.json())
# 以 SEC 精确接收时间 acceptedDate 对齐回测时点,并按 (symbol, fiscalYear, period) 去重
df["pit_time"] = pd.to_datetime(df["acceptedDate"])
df["grossMarginPct"] = (df["grossProfit"] / df["revenue"] * 100).round(2)
df["ebitdaMarginPct"] = (df["ebitda"] / df["revenue"] * 100).round(2)- 返回币种以 reportedCurrency 为准,不要默认全部是美元。
- 需要全市场文件时进入批量数据类别,不要逐公司高频循环。
数据注意事项
4 条实盘要点- 跨国公司对比前先检查 Income Statement(利润表) 返回的
reportedCurrency字段,切勿默认所有公司财报均以 USD 计价。 - 区分公司财年(
fiscalYear)与自然年(calendarYear),单季值(Q1–Q4)与滚动十二个月——Income Statements TTM(TTM 利润表)——不可直接混算。 - 以
(symbol, date, period)作为数据库唯一键,并保留filingDate与acceptedDate以备 Point-in-Time 回测防未来函数。 - 标准化字段无法解释行业特殊科目时,回查 As Reported Financial Statements(原始申报财务报表) 或 Financial Reports Form 10-K JSON(10-K年报数据(JSON)) 核对原始披露口径。
常见问题
4 个问题年度、季度和 TTM 有什么区别?
年度和季度对应正式报告期;TTM 汇总最近十二个月,更适合滚动估值,但不能替代原始季度分析。
Financial Ratios 与 Key Metrics 怎么选?
Ratios 侧重利润率、周转率、偿债与估值比率;Key Metrics 覆盖每股、资本回报和企业价值等综合指标。
标准化报表和 As Reported 有什么区别?
标准化报表将不同公司的科目映射到统一字段;As Reported 尽量保留原始披露标签,更适合审计和字段映射。
为什么部分字段为 null?
公司可能未披露该科目、会计准则映射失败、当前市场不适用,或历史报告缺少对应字段。
接口一览(27个)
8 个功能模块Financial Statements
4 个接口该接口提供全球主要上市公司的跨行业标准化年报与单季利润表。相比格式各异的原始监管申报文件,数据已将不同会计准则与行业的损益科目统一对齐,可直接用于多公司横向同业对比、历史盈利趋势回测与估值建模。
/stable/income-statement该接口返回上市公司详细的资产负债表数据,覆盖资产、负债与股东权益三大块,可用于评估公司的财务结构与偿债能力。
/stable/balance-sheet-statement该接口返回公司完整的现金流量表数据,覆盖经营、投资、筹资三大活动的现金流入流出,可用于评估公司的造血能力与财务可持续性。
/stable/cash-flow-statement该接口按申报时间倒序返回最近提交财报的公司,用于轮询监控全市场财报发布;单家公司的完整三表请用对应的报表接口查询。
/stable/latest-financial-statementsFinancial StatementsTTM
3 个接口该接口返回标的最近十二个月的滚动利润表,用于消除季节性、按月跟踪营收与利润趋势。
/stable/income-statement-ttm该接口返回标的最近十二个月口径的资产负债表,字段结构与年度、季度报表完全一致。
/stable/balance-sheet-statement-ttm该接口返回标的最近十二个月的滚动现金流量表,适合观察经营现金流与自由现金流趋势。
/stable/cash-flow-statement-ttmRatios
4 个接口该接口返回公司的核心财务指标,包括营业收入、净利润、市盈率等,可用于快速评估公司表现并与同业对比。
/stable/key-metrics该接口返回公司的全套财务比率,覆盖盈利能力、流动性、营运效率与杠杆水平,可用于系统性评估公司的经营与财务状况。
/stable/ratios该接口返回公司基于最近四个财季滚动合成(TTM)的核心财务与估值指标,涵盖企业价值倍数(EV/EBITDA)、市盈率、投入资本回报率(ROIC)、自由现金流收益率及营运资本效率,适合全市场横截面选股。
/stable/key-metrics-ttm该接口返回公司最近十二个月(TTM)的滚动财务比率全集,涵盖毛利率、净利率、ROE、ROA、流动比率、速动比率、利息保障倍数与资产周转率,消除单季季节性扰动。
/stable/ratios-ttmAnalysis
3 个接口该接口通过 Altman Z-Score(Z 值评分)、Piotroski 评分、营运资本等关键指标评估公司的财务实力与稳定性,提示破产风险。
/stable/financial-scores该接口返回巴菲特口径的股东盈余(Owner Earnings)序列,以经营现金流扣减维持性资本开支(Maintenance CapEx)并调整营运资本变动,衡量企业可自由分配给股东的真实造血能力。
/stable/owner-earnings该接口返回公司企业价值(EV)及其构成:市值、总债务与现金及现金等价物,兼顾股权与债务的公司总价值,是评估并购与整体估值的核心指标。
/stable/enterprise-valuesGrowth
4 个接口该接口返回指定公司利润表关键科目的同比增长数据:营收、毛利、营业利润、净利润以及各项费用的增长率,用于评估公司的盈利趋势与经营效率。
/stable/income-statement-growth该接口提供资产负债表关键科目的同比增长指标:现金、存货、长期投资等资产变化,流动与非流动负债演变,以及股东权益、留存收益的增减,用于把握公司财务状况的演变。
/stable/balance-sheet-statement-growth该接口衡量公司现金流的增长率:现金流随时间加快增长还是持续收缩一目了然,是评估公司财务健康度与投资风险的重要指标。
/stable/cash-flow-statement-growth该接口计算利润表、资产负债表和现金流量表关键科目的同比增长,覆盖营收、净利润、资产、负债与现金流等指标的变化趋势。
/stable/financial-growthFormats
3 个接口该接口返回标的每个财年、每个期间的财报文件清单,含 JSON 与 XLSX 两种下载地址。
/stable/financial-reports-dates该接口返回美国上市公司向 SEC 提交的年报(Form 10-K)数据,涵盖财务表现、业务经营和风险因素等披露内容。
/stable/financial-reports-json该接口提供可在 Excel 中打开的 10-K 财务报告下载,三大报表数据以电子表格格式交付,便于导入模型做进一步分析。
/stable/financial-reports-xlsxSegmentation
2 个接口该接口按年度或季度拆解上市公司各产品线与核心业务分部的营业收入构成明细(如智能手机、云服务、个人电脑等独立业务板块),清晰呈现各条业务线的收入规模与冷热交替,用于跟踪核心单品放量节奏、新业务第二成长曲线与收入结构演进。
/stable/revenue-product-segmentation该接口按年度或季度拆解上市公司在不同国家与地理区域的营业收入构成(如美洲、欧洲、大中华区、亚太),用于评估海外市场敞口、地缘贸易依赖与汇率敏感度。
/stable/revenue-geographic-segmentationAs Reported
4 个接口该接口返回公司按官方申报口径披露的利润表:营业收入、销货成本、营业费用、营业利润与净利润等原始数据直接来自官方申报文件,未经任何调整。
/stable/income-statement-as-reported该接口返回公司按官方申报口径披露的、未经调整的资产负债表数据:现金、应收款、存货、长期资产、流动与非流动负债、股东权益等明细可直接用于准确的财务评估。
/stable/balance-sheet-statement-as-reported该接口返回公司按官方申报口径披露的、未经调整的现金流量数据:经营、投资、筹资三类现金流直接来自官方报告,可用于分析公司现金管理能力。
/stable/cash-flow-statement-as-reported该接口直接从公司申报文件中获取原始、未经调整的财务报表:利润表、资产负债表与现金流量表均按公司对外披露的原样呈现,可用于详细分析、审计与合规核对。
/stable/financial-statement-full-as-reported