Financial Reports Dates财报披露日期
该接口返回标的每个财年、每个期间的财报文件清单，含 JSON 与 XLSX 两种下载地址。
https://quote-fmp.com/stable/financial-reports-dates?symbol=AAPL数据更新周期
Filing Date · 随 SEC 申报日期更新
接口说明
- 用途是核对与留档：把本地数据库里的财务数据和原始申报文件对上账；做审计、复核或写研究报告时直接下载原始文件，不依赖二手数据源。
- period 与报表接口同源：取值为 全年或 Q1~Q4，与三表接口按 fiscalYear + period 关联即可。
- 覆盖范围有限：只有需要向监管机构申报的市场（美股等）才有完整文件，其他市场可能返回空数组 —— 空数组不等于接口故障。
- 上下游关联接口：Owner Earnings（股东盈余(Owner Earnings)） · Enterprise Values（企业价值查询） · Earnings Transcript（业绩电话会纪要检索） · Stock Price and Volume Data（日线完整行情）
请求参数
1 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
symbol | string | 必填 | AAPL | 美国 SEC 监管申报或美股上市公司股票代码，例如 AAPL、MSFT、NVDA（仅覆盖美股及在美上市 ADR，无需附加交易所后缀）。 |
调用代码示例
Python 关键代码访问 /stable/financial-reports-dates 获取财报披露日期（必填 symbol），单条记录含 linkJson（结构化数据（JSON）链接）、linkXlsx（结构化数据（XLSX）链接）、symbol（证券代码） 等 5 个字段。
resp = requests.get(
"https://quote-fmp.com/stable/financial-reports-dates",
params={"symbol": "AAPL", "apikey": FMP_KEY},
timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 数值化核心指标列 fiscalYear（财政年度）
df["fiscalYear"] = pd.to_numeric(df["fiscalYear"], errors="coerce")参数使用和避坑
2 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法：
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 传入 symbol=AAPL 请求财报披露日期 | symbol=AAPL | 调用 /stable/financial-reports-dates 拉取 AAPL 的财报披露日期，输出 linkJson、linkXlsx、symbol 等 5 项标准化属性。 |
| 跨市场检索 0700.HK 的财报披露日期数据 | symbol=0700.HK | 通过 symbol=0700.HK 请求 /stable/financial-reports-dates，实现财报披露日期在港股市场的同口径采集（含 linkJson、linkXlsx、symbol）。 |
访问 /stable/financial-reports-dates 提取财报披露日期（必填 symbol），单条 JSON 含 linkJson（https://financialmodelin…）等 5 个字段，空列表响应代表该条件下无匹配记录。
从 /stable/financial-reports-dates 抽取 fiscalYear（样本 2026）入库时，以 (symbol, fiscalYear, period) 建唯一索引可安全支持断点续传。
返回数据
5 个字段本接口示例响应共包含 5 个字段（数值型 1 个，文本/日期/布尔型 4 个）。下表列出全部字段名、类型、首条记录真实样本值与中文释义，实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
symbol | string | "AAPL" | 证券代码 |
fiscalYear | number | 2026 | 财政年度 |
period | string | "Q2" | 报告周期 |
linkJson | string | "https://financialmodelingprep.…" | 结构化数据（JSON）链接 |
linkXlsx | string | "https://financialmodelingprep.…" | 结构化数据（XLSX）链接 |
查看响应数据示例（原始 JSON）
[
{
"symbol": "AAPL",
"fiscalYear": 2026,
"period": "Q2",
"linkJson": "https://financialmodelingprep.com/stable/financial-reports-json?symbol=AAPL&year=2026&period=Q2&apikey=YOUR_API_KEY",
"linkXlsx": "https://financialmodelingprep.com/stable/financial-reports-xlsx?symbol=AAPL&year=2026&period=Q2&apikey=YOUR_API_KEY"
}
]常见问题解答（FAQ）
2 个问题如何区分「Formats」模块的财报披露日期与 10-K年报数据(JSON)？/stable/financial-reports-dates 的传参要求是什么？
两者的差异在于入口与字段集：/stable/financial-reports-dates（财报披露日期）要求必填 symbol并产出 5 列（含 linkJson=https://financialmodelin…）；Financial Reports Form 10-K JSON（10-K年报数据(JSON)）要求必填 symbol, year, period并产出 70 列。
拉取 /stable/financial-reports-dates 的财报披露日期数据时，如何处理历史回溯、空结果判定或代码格式？
针对 /stable/financial-reports-dates，推荐向 /stable/financial-reports-dates 传入标准 symbol（港股带 .HK、A 股带 .SS）；这样既能稳定获取 linkJson（结构化数据（JSON）链接），又能避免单次请求载荷过大。
同模块相关接口对比
Formats本接口路径 /stable/financial-reports-dates，必填参数 symbol。 同一模块「Formats」下共 3 个接口，下表列出其余 2 个， 按粒度与查询维度对比，避免选错接口。
| 接口 | 路径 | 核心差异与适用场景 |
|---|---|---|
| 10-K年报数据(JSON)Financial Reports Form 10-K JSON | /stable/financial-reports-json | 美国上市公司向 SEC 提交的年报数据，涵盖财务表现、业务经营和风险因素等披露内容 |
| 10-K年报下载(XLSX)Financial Reports Form 10-K XLSX | /stable/financial-reports-xlsx | 可在 Excel 中打开的 10-K 财务报告下载，三大报表数据以电子表格格式交付 |