Bulk(批量数据)

此类接口提供全市场的批量数据信息,包括公司档案、评级、DCF、财务评分、目标价、比率与关键指标 TTM、三大报表及其增长率,以及日终行情批量文件,都能在单次请求里拿到全市场结果。标的超过几十只时,批量接口省下的时间和配额都很可观;响应体较大,注意超时设置与入库去重。

典型使用场景

4 个场景
财务数据库

按报告期回填并增量同步全市场三大报表。

因子研究

批量同步 TTM 指标、比率、评级和 DCF 快照。

每日行情入库

按交易日下载 EOD 文件并维护本地价格表。

可重复数据管线

用文件哈希、行数和批次元数据保证可审计。

接口怎么选?

6 项选型对照

批量数据类别面向“一次同步一个数据集”,而不是循环调用单公司接口。先确定数据集和报告期,再设计下载、校验、去重和增量更新流程。

批量文件体积、可用年份、市场范围和权限因接口与套餐而异;生产任务应保存校验信息并支持断点和重跑。

你的需求推荐接口选择理由
批量同步公司档案Company Profile Bulk公司概况批量建立证券和公司主数据基础表
批量同步年度或季度利润表Income Statement Bulk利润表批量获取按年份和报告期下载财务数据集
批量同步资产负债表或现金流Balance Sheet Statement Bulk资产负债表批量数据与利润表共同构建三大报表仓库
批量获取 TTM 指标和比率Key Metrics TTM BulkTTM 关键指标批量适合全市场因子和估值筛选
批量获取评级或 DCFStock Rating Bulk评级批量减少逐公司请求并统一快照时间
下载指定日期 EOD 行情Eod Bulk日线行情批量适合每日市场行情入库

数据覆盖与参数口径

  • 适用任务:全市场快照、历史回填、每日增量和本地数据仓库
  • 数据类型:公司资料、评级、DCF、指标、财报、增长率和 EOD
  • 查询维度:按数据集、年份、报告期或交易日期
  • 权限与体积:文件大小和可用范围取决于接口及套餐
  • 工程要求:建议记录下载日期、文件哈希、行数、去重键和失败重试

调用示例

Python 关键代码

示例场景:批量下载指定季度利润表 · 对应接口:Income Statement Bulk(利润表批量获取)

Python(核心参数与字段清洗逻辑)
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 个接口
GETCompany Profile Bulk
公司概况批量

该接口以 CSV 流式分片形式一次性返回全市场上市公司的档案主表(Company Profile Bulk),涵盖市值、行业板块、交易所、ISIN/CUSIP/CIK、CEO 与公司简介,用于本地证券主表建库。

/stable/profile-bulk
GETStock Rating Bulk
评级批量

该接口以单次 CSV 流式响应批量导出全市场股票的综合财务评级快照(Rating Bulk),包含总评级得分及 DCF、ROE、ROA、负债率、PE、PB 各分项打分。

/stable/rating-bulk
GETDCF Valuations Bulk
DCF 批量估值

该接口一次请求即可返回多个代码的现金流折现(DCF)估值:含隐含价格变动空间与百分比差异,适合大规模组合管理与批量筛选。

/stable/dcf-bulk
GETFinancial Scores Bulk
财务评分批量

该接口以单次 CSV 流式响应批量返回全市场股票的 Piotroski F-Score(财务健康度 0–9 分)与 Altman Z-Score(破产风险预警)截面,用于全市场基本面排雷。

/stable/scores-bulk
GETPrice Target Summary Bulk
目标价汇总批量

该接口以单次 CSV 流式响应批量导出全市场覆盖股票的分析师目标价汇总截面,包含近一月、近一季、近一年与全周期的目标价均值及分析师覆盖人数。

/stable/price-target-summary-bulk
GETETF Holder Bulk
ETF持股批量查询

该接口返回 ETF 持仓资产的详细清单:每项资产的持股数量、权重占比、市值,以及 ISIN、CUSIP 等识别码,便于分析 ETF 的资产构成。

/stable/etf-holder-bulk
GETUpgrades Downgrades Consensus Bulk
评级共识批量数据

该接口批量获取全部股票代码的分析师评级总览,一次请求即可拿到分析师上调评级、下调评级与共识推荐,洞察市场对个股的整体预期。

/stable/upgrades-downgrades-consensus-bulk
GETKey Metrics TTM Bulk
TTM 关键指标批量

该接口以单次 CSV 流式响应批量导出全市场上市公司的滚动十二个月(TTM)关键财务指标截面,一步完成多因子估值与盈利质量底表同步。

/stable/key-metrics-ttm-bulk
GETRatios TTM Bulk
TTM 财务比率批量

该接口以单次 CSV 流式响应批量导出全市场上市公司的滚动十二个月(TTM)财务比率截面,涵盖盈利能力、偿债杠杆与运营周转等全套比率。

/stable/ratios-ttm-bulk
GETStock Peers Bulk
同业公司批量

该接口以单次 CSV 流式响应批量导出全市场上市公司的同行业可比公司映射全表,逐行给出每只股票对应的同行竞争对手代码集合,专为本地量化数据库初始化行业相对估值矩阵与配对交易标的池而设计。

/stable/peers-bulk
GETEarnings Surprises Bulk
批量财报超预期

该接口一次返回多家公司年度财报意外数据:实际 EPS 与预期 EPS 对比,快速识别哪些公司超预期、不及预期或符合预期,辅助批量筛选与情绪分析。

/stable/earnings-surprises-bulk

Financials

6 个接口
GETIncome Statement Bulk
利润表批量获取

该接口一次拉取多家公司的利润表数据,涵盖营收、毛利、各项费用与净利润,以标准化格式交付,适合跨行业、跨板块的大规模财务比较分析。

/stable/income-statement-bulk
GETIncome Statement Growth Bulk
利润表增长批量获取

该接口一次获取多家公司的利润表增长数据:营收、净利润、营业利润、费用、EBITDA 和每股收益(EPS)的增长率,适合做横向比较与趋势预测。

/stable/income-statement-growth-bulk
GETBalance Sheet Statement Bulk
资产负债表批量数据

该接口一次请求获取大量公司的资产负债表:总资产、负债、股东权益以及总债务、现金及现金等价物、净应收款等关键科目,适合大规模对比不同公司的财务健康与稳健度。

/stable/balance-sheet-statement-bulk
GETBalance Sheet Statement Growth Bulk
资产负债表增长批量数据

该接口一次请求获取多家公司资产负债表的增长数据:现金与短期投资、应收款、总负债、权益等科目的增长或下降,用于跨公司、跨周期的财务状况对比与长期稳健度评估。

/stable/balance-sheet-statement-growth-bulk
GETCash Flow Statement Bulk
现金流量表批量数据

该接口批量获取大量公司的现金流量表数据:经营、投资、筹资三类现金流动及自由现金流一并获取,用于分析多家公司现金管理能力并横向对比强弱。

/stable/cash-flow-statement-bulk
GETCash Flow Statement Growth Bulk
现金流量表增长批量数据

该接口批量获取多家公司现金流量的增长数据:经营现金流、资本开支、自由现金流等关键指标的变化趋势,用于同时分析多家公司的现金流成长性与财务健康度。

/stable/cash-flow-statement-growth-bulk

Chart

1 个接口
准备好接入批量数据相关接口了吗?接口路径与 FMP 保持兼容,替换域名和 API Key 即可开始。
领取 1 个月试用 Key