按报告期回填并增量同步全市场三大报表。
Bulk(批量数据)
此类接口提供全市场的批量数据信息,包括公司档案、评级、DCF、财务评分、目标价、比率与关键指标 TTM、三大报表及其增长率,以及日终行情批量文件,都能在单次请求里拿到全市场结果。标的超过几十只时,批量接口省下的时间和配额都很可观;响应体较大,注意超时设置与入库去重。
典型使用场景
4 个场景批量同步 TTM 指标、比率、评级和 DCF 快照。
按交易日下载 EOD 文件并维护本地价格表。
用文件哈希、行数和批次元数据保证可审计。
接口怎么选?
6 项选型对照批量数据类别面向“一次同步一个数据集”,而不是循环调用单公司接口。先确定数据集和报告期,再设计下载、校验、去重和增量更新流程。
批量文件体积、可用年份、市场范围和权限因接口与套餐而异;生产任务应保存校验信息并支持断点和重跑。
| 你的需求 | 推荐接口 | 选择理由 |
|---|---|---|
| 批量同步公司档案 | Company Profile Bulk公司概况批量 | 建立证券和公司主数据基础表 |
| 批量同步年度或季度利润表 | Income Statement Bulk利润表批量获取 | 按年份和报告期下载财务数据集 |
| 批量同步资产负债表或现金流 | Balance Sheet Statement Bulk资产负债表批量数据 | 与利润表共同构建三大报表仓库 |
| 批量获取 TTM 指标和比率 | Key Metrics TTM BulkTTM 关键指标批量 | 适合全市场因子和估值筛选 |
| 批量获取评级或 DCF | Stock Rating Bulk评级批量 | 减少逐公司请求并统一快照时间 |
| 下载指定日期 EOD 行情 | Eod Bulk日线行情批量 | 适合每日市场行情入库 |
数据覆盖与参数口径
- 适用任务:全市场快照、历史回填、每日增量和本地数据仓库
- 数据类型:公司资料、评级、DCF、指标、财报、增长率和 EOD
- 查询维度:按数据集、年份、报告期或交易日期
- 权限与体积:文件大小和可用范围取决于接口及套餐
- 工程要求:建议记录下载日期、文件哈希、行数、去重键和失败重试
调用示例
Python 关键代码示例场景:批量下载指定季度利润表 · 对应接口:Income Statement Bulk(利润表批量获取)
import io
resp = requests.get(
"https://quote-fmp.com/stable/income-statement-bulk",
params={"year": "2025", "period": "Q1", "apikey": FMP_KEY},
timeout=60,
)
resp.raise_for_status()
# 利润表批量获取返回 CSV 文本流,使用 io.StringIO 配合 pd.read_csv 解析
df = pd.read_csv(io.StringIO(resp.text))
# 先保留上游时间;非美标的、期末同日或零点时间须核对披露来源,不能直接视为可见日
df["reported_accepted_time"] = pd.to_datetime(df["acceptedDate"], errors="coerce")- Bulk 批量接口返回 CSV 文本流,请使用 pd.read_csv 解析而非 resp.json()。
- 下载完成后记录文件大小、哈希和行数。
数据注意事项
4 条实盘要点- 批量接口——如 Income Statement Bulk(利润表批量获取)、Eod Bulk(日线行情批量)——返回标准 CSV 流,客户端应设置充足超时(建议 60–120 秒)并采用流式落盘解析。
- 三大报表与增长率 Bulk 接口支持按
year与period(如FY或Q1–Q4)拉取;体积较大的接口可通过part参数分片下载。 - 全市场横截面因子筛选推荐组合 Company Profile Bulk(公司概况批量)、Key Metrics TTM Bulk(TTM 关键指标批量)、Ratios TTM Bulk(TTM 财务比率批量) 与 Stock Rating Bulk(评级批量)。
- 每日收盘行情同步直接调用 Eod Bulk(日线行情批量) 传入目标
date,一次请求即可完成全市场日线入库,避免几千次单票循环请求。
常见问题
3 个问题Bulk 和循环调用单公司接口怎么选?
全市场或大量标的优先 Bulk;少量标的和按需查询使用单公司接口更灵活。
批量接口一定返回 JSON 吗?
不一定,部分接口可能返回 CSV 或文件内容,应以详情页和响应头为准。
如何避免重复入库?
为每类数据定义稳定业务键,并记录批次、日期、文件哈希和来源参数。
接口一览(18个)
3 个功能模块Profile
11 个接口该接口以 CSV 流式分片形式一次性返回全市场上市公司的档案主表(Company Profile Bulk),涵盖市值、行业板块、交易所、ISIN/CUSIP/CIK、CEO 与公司简介,用于本地证券主表建库。
/stable/profile-bulk该接口以单次 CSV 流式响应批量导出全市场股票的综合财务评级快照(Rating Bulk),包含总评级得分及 DCF、ROE、ROA、负债率、PE、PB 各分项打分。
/stable/rating-bulk该接口一次请求即可返回多个代码的现金流折现(DCF)估值:含隐含价格变动空间与百分比差异,适合大规模组合管理与批量筛选。
/stable/dcf-bulk该接口以单次 CSV 流式响应批量返回全市场股票的 Piotroski F-Score(财务健康度 0–9 分)与 Altman Z-Score(破产风险预警)截面,用于全市场基本面排雷。
/stable/scores-bulk该接口以单次 CSV 流式响应批量导出全市场覆盖股票的分析师目标价汇总截面,包含近一月、近一季、近一年与全周期的目标价均值及分析师覆盖人数。
/stable/price-target-summary-bulk该接口返回 ETF 持仓资产的详细清单:每项资产的持股数量、权重占比、市值,以及 ISIN、CUSIP 等识别码,便于分析 ETF 的资产构成。
/stable/etf-holder-bulk该接口批量获取全部股票代码的分析师评级总览,一次请求即可拿到分析师上调评级、下调评级与共识推荐,洞察市场对个股的整体预期。
/stable/upgrades-downgrades-consensus-bulk该接口以单次 CSV 流式响应批量导出全市场上市公司的滚动十二个月(TTM)关键财务指标截面,一步完成多因子估值与盈利质量底表同步。
/stable/key-metrics-ttm-bulk该接口以单次 CSV 流式响应批量导出全市场上市公司的滚动十二个月(TTM)财务比率截面,涵盖盈利能力、偿债杠杆与运营周转等全套比率。
/stable/ratios-ttm-bulk该接口以单次 CSV 流式响应批量导出全市场上市公司的同行业可比公司映射全表,逐行给出每只股票对应的同行竞争对手代码集合,专为本地量化数据库初始化行业相对估值矩阵与配对交易标的池而设计。
/stable/peers-bulk该接口一次返回多家公司年度财报意外数据:实际 EPS 与预期 EPS 对比,快速识别哪些公司超预期、不及预期或符合预期,辅助批量筛选与情绪分析。
/stable/earnings-surprises-bulkFinancials
6 个接口该接口一次拉取多家公司的利润表数据,涵盖营收、毛利、各项费用与净利润,以标准化格式交付,适合跨行业、跨板块的大规模财务比较分析。
/stable/income-statement-bulk该接口一次获取多家公司的利润表增长数据:营收、净利润、营业利润、费用、EBITDA 和每股收益(EPS)的增长率,适合做横向比较与趋势预测。
/stable/income-statement-growth-bulk该接口一次请求获取大量公司的资产负债表:总资产、负债、股东权益以及总债务、现金及现金等价物、净应收款等关键科目,适合大规模对比不同公司的财务健康与稳健度。
/stable/balance-sheet-statement-bulk该接口一次请求获取多家公司资产负债表的增长数据:现金与短期投资、应收款、总负债、权益等科目的增长或下降,用于跨公司、跨周期的财务状况对比与长期稳健度评估。
/stable/balance-sheet-statement-growth-bulk该接口批量获取大量公司的现金流量表数据:经营、投资、筹资三类现金流动及自由现金流一并获取,用于分析多家公司现金管理能力并横向对比强弱。
/stable/cash-flow-statement-bulk该接口批量获取多家公司现金流量的增长数据:经营现金流、资本开支、自由现金流等关键指标的变化趋势,用于同时分析多家公司的现金流成长性与财务健康度。
/stable/cash-flow-statement-growth-bulk