Financial Reports Form 10-K XLSX10-K年报下载(XLSX)
该接口提供可在 Excel 中打开的 10-K 财务报告下载,三大报表数据以电子表格格式交付,便于导入模型做进一步分析。
https://quote-fmp.com/stable/financial-reports-xlsx?symbol=AAPL&year=2022&period=FY数据更新周期
Filing Date · 随 SEC 申报日期更新
接口说明
- 详细财务分析:查看利润表、资产负债表、现金流量表等完整财务数据,并利用 Excel 自带的分析工具处理。
- 灵活使用数据:对数据做自定义加工和进一步分析,构建财务模型或跟踪趋势,参考
Cover Page(封面页)与Auditor Information(审计机构信息) 等披露数值,能直观评估标的在同类资产中的相对排位。 - 高效编制报告:基于 10-K 报告数据创建财务摘要、数据透视表和其他可视化内容,日常复盘时可联动同模块的「财报披露日期」,互相印证关键数据的边际变化。
- 二进制工作簿流响应:
/stable/financial-reports-xlsx直接下发.xlsx字节流(非 JSON),Python 端请用pd.read_excel(io.BytesIO(resp.content), sheet_name=None)按工作表字典读取各张原始附表。 - 配套投研接口:Revenue Product Segmentation(分产品营收) · Revenue Geographic Segments(分地区营收) · Income Statement Bulk(利润表批量获取) · Earnings Transcript(业绩电话会纪要检索)
请求参数
3 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
symbol | string | 必填 | AAPL | 美国 SEC 监管申报或美股上市公司股票代码,例如 AAPL、MSFT、NVDA(仅覆盖美股及在美上市 ADR,无需附加交易所后缀)。 |
year | number | 必填 | 2022 | 目标财报/数据的年份,如 2023。 |
period | string | 必填 | Q1,Q2,Q3,Q4,FY | 报告周期:annual(年度)、quarter(季度)、ttm(滚动十二个月)(单值枚举:常规报表传 annual 或 quarter,Bulk 传 Q1..Q4 或 FY;每次仅传单值) |
调用代码示例
Python 关键代码10-K年报数据(XLSX)返回二进制 Excel 工作簿流(resp.content),须用 io.BytesIO 与 pd.read_excel(..., sheet_name=None) 读取各财务附表。
import io
resp = requests.get(
"https://quote-fmp.com/stable/financial-reports-xlsx",
params={"symbol": "AAPL", "year": "2024", "period": "FY", "apikey": FMP_KEY},
timeout=30,
)
resp.raise_for_status()
sheets = pd.read_excel(io.BytesIO(resp.content), sheet_name=None)
first_sheet_df = next(iter(sheets.values())) if sheets else pd.DataFrame()参数使用和避坑
3 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法:
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 提取 AAPL 2024 财年 10-K 披露(10-K年报下载(XLSX)) | symbol=AAPL&year=2024&period=FY | 传 symbol=AAPL、year=2024、period=FY,从 /stable/financial-reports-xlsx 获取 year、Cover Page、Auditor Information 等 SEC 10-K 年报原始数据。 |
| 横向对比 MSFT 2024 财年10-K年报下载(XLSX) | symbol=MSFT&year=2024&period=FY | 切换 symbol=MSFT 获取 2024 财年 year、Cover Page、Auditor Information,对标两家科技龙头的 10-K 年报披露结构。 |
| 回溯 AAPL 2023 财年历史10-K年报下载(XLSX) | symbol=AAPL&year=2023&period=FY | 将 year 改为 2023,核对 AAPL 跨年度 year、Cover Page、Auditor Information 的会计科目连续性。 |
从 /stable/financial-reports-xlsx 采集10-K年报下载(XLSX)(必填 symbol, year, period)后,可获得 year(样本 2022)及 Cover Page(封面页);生产脚本中切勿对空 DataFrame 直接按列名索引。
处理 /stable/financial-reports-xlsx 下发的10-K年报下载(XLSX)记录时,以 (symbol, period) 作为 Upsert 冲突键,同时核对 year(2022)的编码格式。
返回数据
70 个字段本接口示例响应共包含 70 个字段(数值型 0 个,文本/日期/布尔型 70 个)。下表列出全部字段名、类型、首条记录真实样本值与中文释义,实际返回会因接口与数据状态有所不同。
展开全部 70 个字段的完整说明
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
symbol | string | "AAPL" | 证券代码 |
period | string | "FY" | 报告周期 |
year | string | "2022" | 年份 |
Cover Page | array | [… (3)] | 封面页 |
Auditor Information | array | [… (3)] | 审计机构信息 |
CONSOLIDATED STATEMENTS OF OPER | array | [… (3)] | 合并经营报表 |
CONSOLIDATED STATEMENTS OF COMP | array | [… (3)] | 合并综合收益表 |
CONSOLIDATED BALANCE SHEETS | array | [… (3)] | 合并资产负债表 |
CONSOLIDATED BALANCE SHEETS (Pa | array | [… (3)] | 合并资产负债表(母公司口径) |
CONSOLIDATED STATEMENTS OF SHAR | array | [… (3)] | 合并股东权益报表 |
CONSOLIDATED STATEMENTS OF CASH | array | [… (3)] | 合并现金流量表 |
Summary of Significant Accounti | array | [… (3)] | 重要会计政策摘要 |
Revenue | array | [… (3)] | 收入 |
Financial Instruments | array | [… (3)] | 金融工具 |
Consolidated Financial Statemen | array | [… (3)] | 合并财务报表 |
Income Taxes | array | [… (3)] | 所得税 |
Leases | array | [… (3)] | 租赁 |
Debt | array | [… (3)] | 债务 |
Shareholders' Equity | array | [… (3)] | 股东权益 |
Benefit Plans | array | [… (3)] | 员工福利计划 |
Commitments and Contingencies | array | [… (3)] | 承诺与或有事项 |
Segment Information and Geograp | array | [… (3)] | 分部与地区信息 |
Summary of Significant Accoun_2 | array | [… (3)] | 重要会计政策摘要(节 2) |
Summary of Significant Accoun_3 | array | [… (3)] | 重要会计政策摘要(节 3) |
Revenue (Tables) | array | [… (3)] | 收入(表格) |
Financial Instruments (Tables) | array | [… (3)] | 金融工具(表格) |
Consolidated Financial Statem_2 | array | [… (3)] | 合并财务报表(节 2) |
Income Taxes (Tables) | array | [… (3)] | 所得税(表格) |
Leases (Tables) | array | [… (3)] | 租赁(表格) |
Debt (Tables) | array | [… (3)] | 债务(表格) |
Shareholders' Equity (Tables) | array | [… (3)] | 股东权益(表格) |
Benefit Plans (Tables) | array | [… (3)] | 员工福利计划(表格) |
Commitments and Contingencies ( | array | [… (3)] | 承诺与或有事项(表格) |
Segment Information and Geogr_2 | array | [… (3)] | 分部与地区信息(节 2) |
Summary of Significant Accoun_4 | array | [… (3)] | 重要会计政策摘要(节 4) |
Summary of Significant Accoun_5 | array | [… (3)] | 重要会计政策摘要(节 5) |
Revenue - Net Sales Disaggregat | array | [… (3)] | 收入 - 净销售额分解 |
Revenue - Additional Informatio | array | [… (3)] | 收入 - 补充信息 |
Revenue - Deferred Revenue, Exp | array | [… (3)] | 收入 - 递延收入 |
Financial Instruments - Cash, C | array | [… (3)] | 金融工具 - 现金及现金等价物 |
Financial Instruments - Non-Cur | array | [… (3)] | 金融工具 - 非流动部分 |
Financial Instruments - Additio | array | [… (3)] | 金融工具 - 补充信息 |
Financial Instruments - Notiona | array | [… (3)] | 金融工具 - 名义金额 |
Financial Instruments - Gross F | array | [… (3)] | 金融工具 - 公允价值总额 |
Financial Instruments - Derivat | array | [… (3)] | 金融工具 - 衍生品 |
Consolidated Financial Statem_3 | array | [… (3)] | 合并财务报表(节 3) |
Consolidated Financial Statem_4 | array | [… (3)] | 合并财务报表(节 4) |
Consolidated Financial Statem_5 | array | [… (3)] | 合并财务报表(节 5) |
Income Taxes - Provision for In | array | [… (3)] | 所得税 - 所得税费用计提 |
Income Taxes - Additional Infor | array | [… (3)] | 所得税 - 补充信息 |
Income Taxes - Reconciliation o | array | [… (3)] | 所得税 - 实际税率调节 |
Income Taxes - Significant Comp | array | [… (3)] | 所得税 - 重要组成项目 |
Income Taxes - Aggregate Change | array | [… (3)] | 所得税 - 累计变动 |
Leases - Additional Information | array | [… (3)] | 租赁 - 补充信息 |
Leases - ROU Assets and Lease L | array | [… (3)] | 租赁 - 使用权资产与租赁负债 |
Leases - Lease Liability Maturi | array | [… (3)] | 租赁 - 租赁负债到期结构 |
Debt - Additional Information ( | array | [… (3)] | 债务 - 补充信息 |
Debt - Summary of Cash Flows As | array | [… (3)] | 债务 - 现金流量汇总 |
Debt - Summary of Term Debt (De | array | [… (3)] | 债务 - 定期债务汇总 |
Debt - Future Principal Payment | array | [… (3)] | 债务 - 未来本金偿付安排 |
Shareholders' Equity - Addition | array | [… (3)] | 股东权益 - 补充信息 |
Shareholders' Equity - Shares o | array | [… (3)] | 股东权益 - 股份情况 |
Benefit Plans - Additional Info | array | [… (3)] | 员工福利计划 - 补充信息 |
Benefit Plans - Restricted Stoc | array | [… (3)] | 员工福利计划 - 限制性股票 |
Benefit Plans - Summary of Shar | array | [… (3)] | 员工福利计划 - 股份汇总 |
Commitments and Contingencies - | array | [… (3)] | 承诺与或有事项 - 补充信息 |
Segment Information and Geogr_3 | array | [… (3)] | 分部与地区信息(节 3) |
Segment Information and Geogr_4 | array | [… (3)] | 分部与地区信息(节 4) |
Segment Information and Geogr_5 | array | [… (3)] | 分部与地区信息(节 5) |
Segment Information and Geogr_6 | array | [… (3)] | 分部与地区信息(节 6) |
查看响应数据示例(原始 JSON)
[
{
"symbol": "AAPL",
"period": "FY",
"year": "2022",
"Cover Page": [
{
"Cover Page - USD ($) shares in Thousands, $ in Millions": [
"12 Months Ended"
]
},
{
"items": [
"Sep. 24, 2022",
"Oct. 14, 2022",
"Mar. 25, 2022"
]
},
{
"Entity Information [Line Items]": [
" ",
" ",
" "
]
}
],
"Auditor Information": [
{内容已截断,完整字段以实际返回为准。
常见问题解答(FAQ)
2 个问题10-K年报下载(XLSX)和 财报披露日期 属于同一模块,两者的查询键与核心产出字段如何区分?
区分方式很简单:需要 year(年份)和 Cover Page(封面页)这 70 项字段时请求 /stable/financial-reports-xlsx(必填 symbol, year, period);需要 Financial Reports Dates(财报披露日期) 的 5 项字段时请求 /stable/financial-reports-dates(必填 symbol)。
在设计10-K年报下载(XLSX)(/stable/financial-reports-xlsx)的数据拉取管道时,怎样避免单次请求跨度过大或遗漏?
实盘中推荐按需切换 period=annual 或 quarter 请求 /stable/financial-reports-xlsx;通过规范化参数边界,可让 /stable/financial-reports-xlsx 稳定产出 year(年份)等核心业务指标。
同模块相关接口对比
Formats本接口路径 /stable/financial-reports-xlsx,必填参数 symbol、year、period。 同一模块「Formats」下共 3 个接口,下表列出其余 2 个, 按粒度与查询维度对比,避免选错接口。
| 接口 | 路径 | 核心差异与适用场景 |
|---|---|---|
| 财报披露日期Financial Reports Dates | /stable/financial-reports-dates | 标的每个财年、每个期间的财报文件清单,含 JSON 与 XLSX 两种下载地址 |
| 10-K年报数据(JSON)Financial Reports Form 10-K JSON | /stable/financial-reports-json | 美国上市公司向 SEC 提交的年报数据,涵盖财务表现、业务经营和风险因素等披露内容 |