Financial Reports Form 10-K JSON10-K年报数据(JSON)
该接口返回美国上市公司向 SEC 提交的年报(Form 10-K)数据,涵盖财务表现、业务经营和风险因素等披露内容。
https://quote-fmp.com/stable/financial-reports-json?symbol=AAPL&year=2022&period=FY数据更新周期
Filing Date · 随 SEC 申报日期更新
接口说明
- 深度财务分析:获取公司 Form 10-K 中详细的财务报表和数据,评估其上一财年的财务健康度和业绩表现。
- 了解业务经营:了解 10-K 中披露的公司经营情况,包括业务战略、主要市场和经营挑战,通过提取
Cover Page(封面页)与Auditor Information(审计机构信息) 等字段,可在 Pandas 中快速构建多因子暴露矩阵。 - 评估风险因素:查阅 Form 10-K 的风险因素部分,了解公司面临的潜在挑战与不确定性,为投资决策提供依据。
- 跨模块关联接口:Balance Sheet Statement Growth(资产负债表增长数据) · Cashflow Statement Growth(现金流量表增长数据) · Financial Estimates(分析师预期查询) · Income Statement Bulk(利润表批量获取)
请求参数
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年报数据(JSON)(/stable/financial-reports-json)内含动态嵌套字典(含 year(年份)、Cover Page(封面页)、Auditor Information(审计机构信息)),通过 pd.json_normalize(resp.json()) 可自动展平内层科目。
resp = requests.get(
"https://quote-fmp.com/stable/financial-reports-json",
params={"symbol": "AAPL", "year": "2024", "period": "FY", "apikey": FMP_KEY},
timeout=20,
)
resp.raise_for_status()
df = pd.json_normalize(resp.json())参数使用和避坑
3 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法:
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 提取 AAPL 2024 财年 10-K 披露(10-K年报数据(JSON)) | symbol=AAPL&year=2024&period=FY | 传 symbol=AAPL、year=2024、period=FY,从 /stable/financial-reports-json 获取 year、Cover Page、Auditor Information 等 SEC 10-K 年报原始数据。 |
| 横向对比 MSFT 2024 财年10-K年报数据(JSON) | symbol=MSFT&year=2024&period=FY | 切换 symbol=MSFT 获取 2024 财年 year、Cover Page、Auditor Information,对标两家科技龙头的 10-K 年报披露结构。 |
| 回溯 AAPL 2023 财年历史10-K年报数据(JSON) | symbol=AAPL&year=2023&period=FY | 将 year 改为 2023,核对 AAPL 跨年度 year、Cover Page、Auditor Information 的会计科目连续性。 |
/stable/financial-reports-json(必填 symbol, year, period)返回的 year(年份,样本 2022)与 Cover Page 按最新记录置顶;算环比或滚动均值前请先按时间升序重排。
10-K年报数据(JSON)返回的 year(年份,示例 2022)在增量同步时,应按 (symbol, period) 覆盖更新已有记录,保证本地维表幂等。
返回数据
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年报数据(JSON)(/stable/financial-reports-json)与同模块的 财报披露日期?
在「Formats」模块内,10-K年报数据(JSON)(/stable/financial-reports-json,必填 symbol, year, period)负责输出 year 与 Cover Page 等 70 项指标,Financial Reports Dates(财报披露日期)负责输出 5 项指标。
调用 /stable/financial-reports-json 采集10-K年报数据(JSON)时,如何设计参数控制与批量请求策略?
工程上推荐在 /stable/financial-reports-json 中区分年度(annual)与单季(quarter)拉取;同时复用 requests.Session() 保持 HTTP Keep-Alive,直接提取 year 与 Cover Page。
同模块相关接口对比
Formats本接口路径 /stable/financial-reports-json,必填参数 symbol、year、period。 同一模块「Formats」下共 3 个接口,下表列出其余 2 个, 按粒度与查询维度对比,避免选错接口。
| 接口 | 路径 | 核心差异与适用场景 |
|---|---|---|
| 财报披露日期Financial Reports Dates | /stable/financial-reports-dates | 标的每个财年、每个期间的财报文件清单,含 JSON 与 XLSX 两种下载地址 |
| 10-K年报下载(XLSX)Financial Reports Form 10-K XLSX | /stable/financial-reports-xlsx | 可在 Excel 中打开的 10-K 财务报告下载,三大报表数据以电子表格格式交付 |