Financial Reports Form 10-K JSON10-K年报数据(JSON)

该接口返回美国上市公司向 SEC 提交的年报(Form 10-K)数据,涵盖财务表现、业务经营和风险因素等披露内容。

GEThttps://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 个参数
参数类型要求示例说明
symbolstring必填AAPL美国 SEC 监管申报或美股上市公司股票代码,例如 AAPL、MSFT、NVDA(仅覆盖美股及在美上市 ADR,无需附加交易所后缀)。
yearnumber必填2022目标财报/数据的年份,如 2023。
periodstring必填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()) 可自动展平内层科目。

Python(核心参数与字段清洗逻辑)
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 的会计科目连续性。
时序与查询边界10-K年报数据(JSON):/stable/financial-reports-json(必填 symbol, year, period)与 year 排序规范

/stable/financial-reports-json(必填 symbol, year, period)返回的 year(年份,样本 2022)与 Cover Page 按最新记录置顶;算环比或滚动均值前请先按时间升序重排。

落库主键与口径同步10-K年报数据(JSON):用 (symbol, period) 锁定唯一行并去除 year 空白符

10-K年报数据(JSON)返回的 year(年份,示例 2022)在增量同步时,应按 (symbol, period) 覆盖更新已有记录,保证本地维表幂等。

返回数据

70 个字段

本接口示例响应共包含 70 个字段(数值型 0 个,文本/日期/布尔型 70 个)。下表列出全部字段名、类型、首条记录真实样本值与中文释义,实际返回会因接口与数据状态有所不同。

展开全部 70 个字段的完整说明
字段类型示例值说明
symbolstring"AAPL"证券代码
periodstring"FY"报告周期
yearstring"2022"年份
Cover Pagearray[… (3)]封面页
Auditor Informationarray[… (3)]审计机构信息
CONSOLIDATED STATEMENTS OF OPERarray[… (3)]合并经营报表
CONSOLIDATED STATEMENTS OF COMParray[… (3)]合并综合收益表
CONSOLIDATED BALANCE SHEETSarray[… (3)]合并资产负债表
CONSOLIDATED BALANCE SHEETS (Paarray[… (3)]合并资产负债表(母公司口径)
CONSOLIDATED STATEMENTS OF SHARarray[… (3)]合并股东权益报表
CONSOLIDATED STATEMENTS OF CASHarray[… (3)]合并现金流量表
Summary of Significant Accountiarray[… (3)]重要会计政策摘要
Revenuearray[… (3)]收入
Financial Instrumentsarray[… (3)]金融工具
Consolidated Financial Statemenarray[… (3)]合并财务报表
Income Taxesarray[… (3)]所得税
Leasesarray[… (3)]租赁
Debtarray[… (3)]债务
Shareholders' Equityarray[… (3)]股东权益
Benefit Plansarray[… (3)]员工福利计划
Commitments and Contingenciesarray[… (3)]承诺与或有事项
Segment Information and Geograparray[… (3)]分部与地区信息
Summary of Significant Accoun_2array[… (3)]重要会计政策摘要(节 2)
Summary of Significant Accoun_3array[… (3)]重要会计政策摘要(节 3)
Revenue (Tables)array[… (3)]收入(表格)
Financial Instruments (Tables)array[… (3)]金融工具(表格)
Consolidated Financial Statem_2array[… (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_2array[… (3)]分部与地区信息(节 2)
Summary of Significant Accoun_4array[… (3)]重要会计政策摘要(节 4)
Summary of Significant Accoun_5array[… (3)]重要会计政策摘要(节 5)
Revenue - Net Sales Disaggregatarray[… (3)]收入 - 净销售额分解
Revenue - Additional Informatioarray[… (3)]收入 - 补充信息
Revenue - Deferred Revenue, Exparray[… (3)]收入 - 递延收入
Financial Instruments - Cash, Carray[… (3)]金融工具 - 现金及现金等价物
Financial Instruments - Non-Curarray[… (3)]金融工具 - 非流动部分
Financial Instruments - Additioarray[… (3)]金融工具 - 补充信息
Financial Instruments - Notionaarray[… (3)]金融工具 - 名义金额
Financial Instruments - Gross Farray[… (3)]金融工具 - 公允价值总额
Financial Instruments - Derivatarray[… (3)]金融工具 - 衍生品
Consolidated Financial Statem_3array[… (3)]合并财务报表(节 3)
Consolidated Financial Statem_4array[… (3)]合并财务报表(节 4)
Consolidated Financial Statem_5array[… (3)]合并财务报表(节 5)
Income Taxes - Provision for Inarray[… (3)]所得税 - 所得税费用计提
Income Taxes - Additional Inforarray[… (3)]所得税 - 补充信息
Income Taxes - Reconciliation oarray[… (3)]所得税 - 实际税率调节
Income Taxes - Significant Comparray[… (3)]所得税 - 重要组成项目
Income Taxes - Aggregate Changearray[… (3)]所得税 - 累计变动
Leases - Additional Informationarray[… (3)]租赁 - 补充信息
Leases - ROU Assets and Lease Larray[… (3)]租赁 - 使用权资产与租赁负债
Leases - Lease Liability Maturiarray[… (3)]租赁 - 租赁负债到期结构
Debt - Additional Information (array[… (3)]债务 - 补充信息
Debt - Summary of Cash Flows Asarray[… (3)]债务 - 现金流量汇总
Debt - Summary of Term Debt (Dearray[… (3)]债务 - 定期债务汇总
Debt - Future Principal Paymentarray[… (3)]债务 - 未来本金偿付安排
Shareholders' Equity - Additionarray[… (3)]股东权益 - 补充信息
Shareholders' Equity - Shares oarray[… (3)]股东权益 - 股份情况
Benefit Plans - Additional Infoarray[… (3)]员工福利计划 - 补充信息
Benefit Plans - Restricted Stocarray[… (3)]员工福利计划 - 限制性股票
Benefit Plans - Summary of Shararray[… (3)]员工福利计划 - 股份汇总
Commitments and Contingencies -array[… (3)]承诺与或有事项 - 补充信息
Segment Information and Geogr_3array[… (3)]分部与地区信息(节 3)
Segment Information and Geogr_4array[… (3)]分部与地区信息(节 4)
Segment Information and Geogr_5array[… (3)]分部与地区信息(节 5)
Segment Information and Geogr_6array[… (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 财务报告下载,三大报表数据以电子表格格式交付

Statements(财务报表)全部接口目录 →

需要稳定访问 10-K年报数据(JSON) 数据?注册即可获取专属 API Key,免费体验全部接口。
免费试用 1 个月