Latest Financial Statements最新财务报表
该接口按申报时间倒序返回最近提交财报的公司,用于轮询监控全市场财报发布;单家公司的完整三表请用对应的报表接口查询。
https://quote-fmp.com/stable/latest-financial-statements?page=0&limit=250数据更新周期
Filing Date · 随 SEC 申报日期更新
接口说明
- 返回的是一次申报的定位信息:symbol、财年、期间、报表期末日与 入库时间。按 dateAdded 倒序即「最新申报」。
- 要翻页取全量:page 从 0 开始,limit 控制每页条数(示例 250)。财报季密集时一天可能出现上千条,只取第一页会漏掉大半。
- 与三表接口的分工:本接口只回答「哪家公司、哪个期间、什么时候报的」,具体科目数值要用利润表 / 资产负债表 / 现金流量表接口按 symbol 再查一次。
- 关联数据线接口:As Reported Cashflow Statements(原始申报现金流量表) · As Reported Financial Statements(原始申报财务报表) · Income Statement Bulk(利润表批量获取) · Earnings Transcript(业绩电话会纪要检索)
请求参数
2 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
page | number | 可选 | 0 | 分页页码,从 0 开始,配合每页条数翻页取更多数据(从 0 起算的分页游标;当响应返回空数组 [] 时代表已翻至历史末页) |
limit | number | 可选 | 250 | 返回结果条数上限,用于控制单次响应大小。 |
调用代码示例
Python 关键代码拉取 最新财务报表 只需访问 /stable/latest-financial-statements(可选 page, limit),结果涵盖 calendarYear(日历年份)、dateAdded(加入日期)、symbol(证券代码)(calendarYear=2026)。
resp = requests.get(
"https://quote-fmp.com/stable/latest-financial-statements",
params={"page": 0, "limit": 250, "apikey": FMP_KEY},
timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 按 date 升序重排并数值化 calendarYear(日历年份)
df["calendarYear"] = pd.to_numeric(df["calendarYear"], errors="coerce")
df = df.sort_values("date").reset_index(drop=True)参数使用和避坑
2 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法:
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 读取最新财务报表最新首屏流(page=0, limit=50) | page=0&limit=50 | 请求 /stable/latest-financial-statements 首屏记录,获取最新披露的 calendarYear、dateAdded、symbol(样本 calendarYear=2026)。 |
| 递增游标翻页回填最新财务报表(page=1, limit=100) | page=1&limit=100 | 向 /stable/latest-financial-statements 传 page=1&limit=100,向历史纵深翻页归档 calendarYear、dateAdded、symbol 等 5 列。 |
在最新财务报表(/stable/latest-financial-statements)中,首条样本的 calendarYear 为 2026、dateAdded 为 2026-07-30 13:17:26;批量采集时请按可选 page, limit校验传参格式。
存储最新财务报表(/stable/latest-financial-statements)数据时,联合键 (symbol, date, period) 能唯一标识每条截面;注意 calendarYear(日历年份,样本 2026)采用原始计价单位。
返回数据
5 个字段本接口示例响应共包含 5 个字段(数值型 1 个,文本/日期/布尔型 4 个)。下表列出全部字段名、类型、首条记录真实样本值与中文释义,实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
symbol | string | "UFPI" | 证券代码 |
calendarYear | number | 2026 | 日历年份 |
period | string | "Q2" | 报告周期 |
date | string | "2026-06-27" | 日期 |
dateAdded | string | "2026-07-30 13:17:26" | 加入日期 |
查看响应数据示例(原始 JSON)
[
{
"symbol": "UFPI",
"calendarYear": 2026,
"period": "Q2",
"date": "2026-06-27",
"dateAdded": "2026-07-30 13:17:26"
}
]计算口径对照:本接口涉及的三大财务报表标准化科目的底层兜底计算逻辑,可查看 财务报表解析与兜底计算公式 →
常见问题解答(FAQ)
2 个问题使用「Financial Statements」接口族时,最新财务报表(可选 page, limit)与 利润表(必填 symbol)怎么选?
按输入参数看,/stable/latest-financial-statements(最新财务报表)为可选 page, limit,产出 calendarYear(2026)等 5 列;/stable/income-statement(Income Statement(利润表))为必填 symbol,产出 39 列。
在自动化流水线中对接最新财务报表(/stable/latest-financial-statements),怎样平衡拉取深度与请求效率?
最佳实践是向 /stable/latest-financial-statements 传分页参数并在收到空数组时终止循环;解析响应中的 calendarYear(如 2026)前,请确保对异常空值和网络超时设置退避重试。
同模块相关接口对比
Financial Statements本接口路径 /stable/latest-financial-statements,无必填参数。 同一模块「Financial Statements」下共 4 个接口,下表列出其余 3 个, 按粒度与查询维度对比,避免选错接口。