Key Metrics TTM BulkTTM 关键指标批量
该接口以单次 CSV 流式响应批量导出全市场上市公司的滚动十二个月（TTM）关键财务指标截面，一步完成多因子估值与盈利质量底表同步。
GET
https://quote-fmp.com/stable/key-metrics-ttm-bulk数据更新周期
4-6 Hours
接口说明
- 市值与企业价值指标：获取 TTM 市值、企业价值(EV),以及 EV/营收、EV/经营现金流、EV/自由现金流等估值倍数。
- 盈利能力与回报比率：跟踪总资产收益率（ROA）、净资产收益率（ROE）、投入资本回报率（ROIC）等关键比率。
- 运营效率指标：现金转换周期、应付账款周转天数、应收账款周转天数、存货周转天数等，反映公司的运营效率，日常复盘时可联动同模块的「评级共识批量数据」，互相印证关键数据的边际变化。
- 流式导出响应：调用
/stable/key-metrics-ttm-bulk获取TTM 关键指标批量时返回标准 CSV 流，切勿调用resp.json()，推荐解析后直接存为本地 Parquet 分区文件。 - 关联数据线接口：Income Statement Growth Bulk（利润表增长批量获取） · Balance Sheet Statement Bulk（资产负债表批量数据） · Company Profile Data（公司概况） · Financial Statement Symbols List（报表公司清单）
调用代码示例
Python 关键代码/stable/key-metrics-ttm-bulk 单次流式返回全市场TTM 关键指标批量（含 marketCap（总市值）、enterpriseValueTTM（企业价值（EV，TTM））、evToSalesTTM（企业价值倍数（EV/Sales，TTM））），不可调 resp.json()，建议用 pd.read_csv 解析后存为 Parquet。
Python（核心参数与字段清洗逻辑）
import io
resp = requests.get(
"https://quote-fmp.com/stable/key-metrics-ttm-bulk",
params={"apikey": FMP_KEY},
timeout=60,
)
resp.raise_for_status()
# TTM 关键指标批量返回 CSV 文本流，使用 io.StringIO 配合 pd.read_csv 解析
df = pd.read_csv(io.StringIO(resp.text))
df["marketCap"] = pd.to_numeric(df["marketCap"], errors="coerce")参数使用和避坑
3 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法：
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 一次性拉取全量TTM 关键指标批量初始化本地主表 | GET /stable/key-metrics-ttm-bulk（免参数） | /stable/key-metrics-ttm-bulk 为一次性全量输出（43 列，含 marketCap、enterpriseValueTTM、evToSalesTTM）；首次建库与周期性覆盖都走它。 |
| 以 symbol 为唯一键覆盖写入，避免全表重复 | GET /stable/key-metrics-ttm-bulk → upsert on symbol | symbol 在全表内唯一（样本 000001.SZ），43 列按该键 upsert 即可幂等；无法按单条重取，补数须重跑全量。 |
| 落库后自检：symbol 唯一性与 marketCap 空值率 | GET /stable/key-metrics-ttm-bulk → count(distinct symbol) / null_ratio(marketCap) | 本表共 43 列。落库后先比对 count(distinct symbol) 与总行数确认无重复；再统计 marketCap（样本 249171756000）的空值比例，判断该批次是否拉到完整截面。 |
CSV 流式解析TTM 关键指标批量：/stable/key-metrics-ttm-bulk 下发 CSV 文本流，切勿调 resp.json()
TTM 关键指标批量接口 /stable/key-metrics-ttm-bulk 采用 CSV 流格式下发 marketCap（249171756000）等全市场截面，请求时建议设 timeout=60 并以 io.StringIO 解析。
落库主键与口径清洗 /stable/key-metrics-ttm-bulk：按 (symbol) Upsert 并处理 marketCap 空值
对TTM 关键指标批量（/stable/key-metrics-ttm-bulk）执行增量 ETL 时，通过 (symbol) 唯一约束幂等写入，并将 marketCap（总市值）与 enterpriseValueTTM（企业价值（EV，TTM）） 统一转为浮点列。
返回数据
43 个字段本接口示例响应共包含 43 个字段（数值型 0 个，文本/日期/布尔型 43 个）。下表列出全部字段名、类型、首条记录真实样本值与中文释义，实际返回会因接口与数据状态有所不同。
展开全部 43 个字段的完整说明
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
symbol | string | "000001.SZ" | 证券代码 |
marketCap | string | "249171756000" | 总市值 |
enterpriseValueTTM | string | "-496959244000" | 企业价值（EV，TTM） |
evToSalesTTM | string | "-2.95816117050406" | 企业价值倍数（EV/Sales，TTM） |
evToOperatingCashFlowTTM | string | "-2.9831814247210167" | 企业价值倍数（EV/OCF，TTM） |
evToFreeCashFlowTTM | string | "-3.028355803098073" | 企业价值倍数（EV/FCF，TTM） |
evToEBITDATTM | string | "-14.656106051669223" | 企业价值倍数（EV/EBITDA，TTM） |
netDebtToEBITDATTM | string | "-22.004571192638906" | 净债务对 EBITDA 比（TTM） |
currentRatioTTM | string | "0" | 流动比率（TTM） |
incomeQualityTTM | string | "15.217593861331872" | 盈利质量（TTM） |
grahamNumberTTM | string | "31.017865999534138" | 格雷厄姆数（TTM） |
grahamNetNetTTM | string | "-199.05514330278228" | 格雷厄姆净净值（TTM） |
taxBurdenTTM | string | "0.8225101702576465" | 税收负担率（TTM） |
interestBurdenTTM | string | "1.4030970878917606" | 利息负担率（TTM） |
workingCapitalTTM | string | "746131000000" | 营运资本（TTM） |
investedCapitalTTM | string | "772543000000" | 投入资本（TTM） |
returnOnAssetsTTM | string | "0.007558510437605078" | 总资产收益率（ROA，TTM） |
operatingReturnOnAssetsTTM | string | "0.013555578495362656" | 经营性资产收益率（TTM） |
returnOnTangibleAssetsTTM | string | "0.007576346366296015" | 有形资产回报率（TTM） |
returnOnEquityTTM | string | "0.09082717681735725" | 净资产收益率（ROE，TTM） |
returnOnInvestedCapitalTTM | string | "0.011141314993384131" | 投入资本回报率（ROIC，TTM） |
returnOnCapitalEmployedTTM | string | "0.013545504233575834" | 已动用资本回报率（ROCE，TTM） |
earningsYieldTTM | string | "0.14960077934639543" | 盈利收益率（TTM） |
freeCashFlowYieldTTM | string | "0.6585898925077207" | 自由现金流收益率（TTM） |
capexToOperatingCashFlowTTM | string | "0.014917130388325619" | 资本开支对经营现金流比（TTM） |
capexToDepreciationTTM | string | "1.855862584017924" | 资本开支对折旧比（TTM） |
capexToRevenueTTM | string | "0.014792018857591847" | 资本开支对营收比（TTM） |
salesGeneralAndAdministrativeToRevenueTTM | string | "0.10163337222314817" | 销售管理费用对营收比（TTM） |
researchAndDevelopementToRevenueTTM | string | "0" | 研发费用对营收比（TTM） |
stockBasedCompensationToRevenueTTM | string | "0" | 股权激励对营收比（TTM） |
intangiblesToTotalAssetsTTM | string | "0.002354159621091415" | 无形资产对总资产比（TTM） |
averageReceivablesTTM | string | "0" | 平均应收账款（TTM） |
averagePayablesTTM | string | "0" | 平均应付账款（TTM） |
averageInventoryTTM | string | "0" | 平均存货（TTM） |
daysOfSalesOutstandingTTM | string | "0" | 应收账款周转天数（DSO，TTM） |
daysOfPayablesOutstandingTTM | string | "0" | 应付账款周转天数（DPO，TTM） |
daysOfInventoryOutstandingTTM | string | "0" | 存货周转天数（DIO，TTM） |
operatingCycleTTM | string | "0" | 营业周期（TTM） |
cashConversionCycleTTM | string | "0" | 现金转换周期（CCC，TTM） |
freeCashFlowToEquityTTM | string | "910233000000" | 股权自由现金流（FCFE，TTM） |
freeCashFlowToFirmTTM | string | "-35237570137.11014" | 公司自由现金流（FCFF，TTM） |
tangibleAssetValueTTM | string | "492510000000" | 有形资产价值（TTM） |
netCurrentAssetValueTTM | string | "-4525615000000" | 净流动资产价值（TTM） |
查看响应数据示例（原始 JSON）
[
{
"symbol": "000001.SZ",
"marketCap": "249171756000",
"enterpriseValueTTM": "-496959244000",
"evToSalesTTM": "-2.95816117050406",
"evToOperatingCashFlowTTM": "-2.9831814247210167",
"evToFreeCashFlowTTM": "-3.028355803098073",
"evToEBITDATTM": "-14.656106051669223",
"netDebtToEBITDATTM": "-22.004571192638906",
"currentRatioTTM": "0",
"incomeQualityTTM": "15.217593861331872",
"grahamNumberTTM": "31.017865999534138",
"grahamNetNetTTM": "-199.05514330278228",
"taxBurdenTTM": "0.8225101702576465",
"interestBurdenTTM": "1.4030970878917606",
"workingCapitalTTM": "746131000000",
"investedCapitalTTM": "772543000000",
"returnOnAssetsTTM": "0.007558510437605078",
"operatingReturnOnAssetsTTM": "0.013555578495362656",
"returnOnTangibleAssetsTTM": "0.007576346366296015",
"returnOnEquityTTM": "0.09082717681735725",
"returnOnInvestedCapitalTTM": "0.011141314993384131",
"returnOnCapitalEmployedTTM": "0.013545504233575834",
"earningsYieldTTM": "0.14960077934639543",
"freeCashFlowYieldTTM": "0.6585898925077207",
"capexToOperatingCashFlowTTM": "0.014917130388325619",
"capexToDepreciationTTM": "1.855862584017924",内容已截断，完整字段以实际返回为准。
计算口径对照：本接口涉及的批量 TTM 关键指标各字段的计算公式说明，可查看 关键财务指标与比率公式大全 →
常见问题解答（FAQ）
2 个问题投研选型时，什么场景用TTM 关键指标批量（/stable/key-metrics-ttm-bulk），什么场景改用 公司概况批量？
当您需要 marketCap（总市值，如 249171756000）与 enterpriseValueTTM（企业价值（EV，TTM））时调 TTM 关键指标批量（/stable/key-metrics-ttm-bulk，免业务参数）；反之若侧重 Company Profile Bulk（公司概况批量） 的维度，则请求 /stable/profile-bulk（必填 part）。
在脚本里循环或定时请求 /stable/key-metrics-ttm-bulk（TTM 关键指标批量）时，有哪些调度细节要注意？
在脚本编排上，建议直接请求无参端点 /stable/key-metrics-ttm-bulk 拉取全表快照并缓存；将每次从 /stable/key-metrics-ttm-bulk 拿到的 marketCap（总市值）按批次追加至本地历史表。
同模块相关接口对比
Profile本接口路径 /stable/key-metrics-ttm-bulk，无必填参数。 同一模块「Profile」下共 11 个接口，下表列出其余 10 个， 按粒度与查询维度对比，避免选错接口。
| 接口 | 路径 | 核心差异与适用场景 |
|---|---|---|
| 公司概况批量Company Profile Bulk | /stable/profile-bulk | 以 CSV 流式分片形式一次性返回全市场上市公司的档案主表 |
| 评级批量Stock Rating Bulk | /stable/rating-bulk | 以单次 CSV 流式响应批量导出全市场股票的综合财务评级快照 |
| DCF 批量估值DCF Valuations Bulk | /stable/dcf-bulk | 一次请求即可返回多个代码的现金流折现（DCF）估值，含隐含价格变动空间与百分比差异 |
| 财务评分批量Financial Scores Bulk | /stable/scores-bulk | 以单次 CSV 流式响应批量返回全市场股票的 Piotroski F-Score与 Altman Z-Score截面 |
| 目标价汇总批量Price Target Summary Bulk | /stable/price-target-summary-bulk | 以单次 CSV 流式响应批量导出全市场覆盖股票的分析师目标价汇总截面 |
| ETF持股批量查询ETF Holder Bulk | /stable/etf-holder-bulk | ETF 持仓资产的详细清单，每项资产的持股数量、权重占比、市值 |
| 评级共识批量数据Upgrades Downgrades Consensus Bulk | /stable/upgrades-downgrades-consensus-bulk | 批量获取全部股票代码的分析师评级总览，一次请求即可拿到分析师上调评级、下调评级与共识推荐 |
| TTM 财务比率批量Ratios TTM Bulk | /stable/ratios-ttm-bulk | 以单次 CSV 流式响应批量导出全市场上市公司的滚动十二个月（TTM）财务比率截面 |
| 同业公司批量Stock Peers Bulk | /stable/peers-bulk | 以单次 CSV 流式响应批量导出全市场上市公司的同行业可比公司映射全表 |
| 批量财报超预期Earnings Surprises Bulk | /stable/earnings-surprises-bulk | 一次返回多家公司年度财报意外数据，实际 EPS 与预期 EPS 对比 |
需要稳定访问 TTM 关键指标批量 数据？注册即可获取专属 API Key，免费体验全部接口。
免费试用 1 个月