Key Metrics TTMTTM 关键指标
该接口返回公司基于最近四个财季滚动合成(TTM)的核心财务与估值指标,涵盖企业价值倍数(EV/EBITDA)、市盈率、投入资本回报率(ROIC)、自由现金流收益率及营运资本效率,适合全市场横截面选股。
https://quote-fmp.com/stable/key-metrics-ttm?symbol=AAPL数据更新周期
该接口暂无固定更新周期(多为按需更新的参考或静态数据)。
接口说明
- 盈利能力评估:通过总资产收益率(ROA)、盈利收益率等指标了解公司的盈利能力,传入
symbol后可拿到marketCap(总市值)、enterpriseValueTTM(企业价值(EV,TTM))与evToSalesTTM(企业价值倍数(EV/Sales,TTM)) 等明细项,便于在 Python 或 SQL 中直接聚合。 - 流动性与偿债能力分析:用流动比率、现金转换周期等比率评估公司管理短期债务的效率,抽取
enterpriseValueTTM(企业价值(EV,TTM))与evToSalesTTM(企业价值倍数(EV/Sales,TTM)) 等关键维度,能够显著提升样本筛选与标的池初筛效率。 - 资本效率:用投入资本回报率(ROIC)、净资产收益率(ROE)等指标评估公司运用资本的效率,在盘前准备或盘后归档中,常与「关键指标」成对调用以保持底表同步。
- 配套投研接口:Cashflow Statements TTM(TTM 现金流量表) · Financial Scores(财务健康评分) · Income Statement Bulk(利润表批量获取) · Earnings Transcript(业绩电话会纪要检索)
请求参数
1 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
symbol | string | 必填 | AAPL | 证券代码,例如 AAPL 或 MSFT(美股直传代码如 AAPL;港股/英股/A股须带交易所后缀,如 0700.HK、600519.SS) |
调用代码示例
Python 关键代码/stable/key-metrics-ttm 端点(TTM 关键指标)接收必填 symbol,返回 marketCap(总市值)、enterpriseValueTTM(企业价值(EV,TTM))、evToSalesTTM(企业价值倍数(EV/Sales,TTM)) 等 43 项指标。
resp = requests.get(
"https://quote-fmp.com/stable/key-metrics-ttm",
params={"symbol": "AAPL", "apikey": FMP_KEY},
timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 数值化核心指标列 marketCap(总市值)
df["marketCap"] = pd.to_numeric(df["marketCap"], errors="coerce")参数使用和避坑
2 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法:
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 查询 AAPL 的TTM 关键指标明细(symbol=AAPL) | symbol=AAPL | 向 /stable/key-metrics-ttm 传 symbol=AAPL,返回包含 marketCap、enterpriseValueTTM、evToSalesTTM(如 marketCap=4874072686740)在内的 43 项字段。 |
| 港股腾讯(0700.HK)跨市场TTM 关键指标拉取 | symbol=0700.HK | 传入 0700.HK 调用 /stable/key-metrics-ttm,获取港股标的的 marketCap、enterpriseValueTTM、evToSalesTTM(共 43 列)。 |
从 /stable/key-metrics-ttm 采集TTM 关键指标(必填 symbol)后,可获得 marketCap(样本 4874072686740);生产脚本中切勿对空 DataFrame 直接按列名索引。
处理 /stable/key-metrics-ttm 下发的TTM 关键指标记录时,以 (symbol) 作为 Upsert 冲突键,同时核对 marketCap(4874072686740)的数值单位。
返回数据
43 个字段本接口示例响应共包含 43 个字段(数值型 42 个,文本/日期/布尔型 1 个)。下表列出全部字段名、类型、首条记录真实样本值与中文释义,实际返回会因接口与数据状态有所不同。
展开全部 43 个字段的完整说明
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
symbol | string | "AAPL" | 证券代码 |
marketCap | number | 4874072686740 | 总市值 |
enterpriseValueTTM | number | 4922455686740 | 企业价值(EV,TTM) |
evToSalesTTM | number | 10.903849634593149 | 企业价值倍数(EV/Sales,TTM) |
evToOperatingCashFlowTTM | number | 35.10473168789491 | 企业价值倍数(EV/OCF,TTM) |
evToFreeCashFlowTTM | number | 38.107170845061695 | 企业价值倍数(EV/FCF,TTM) |
evToEBITDATTM | number | 30.701642134695508 | 企业价值倍数(EV/EBITDA,TTM) |
netDebtToEBITDATTM | number | 0.3017675822667964 | 净债务对 EBITDA 比(TTM) |
currentRatioTTM | number | 1.07035746912159 | 流动比率(TTM) |
incomeQualityTTM | number | 1.1439689985723027 | 盈利质量(TTM) |
grahamNumberTTM | number | 36.83959035988331 | 格雷厄姆数(TTM) |
grahamNetNetTTM | number | -10.37184248926531 | 格雷厄姆净净值(TTM) |
taxBurdenTTM | number | 0.8300602695198754 | 税收负担率(TTM) |
interestBurdenTTM | number | 1 | 利息负担率(TTM) |
workingCapitalTTM | number | 9473000000 | 营运资本(TTM) |
investedCapitalTTM | number | 80923000000 | 投入资本(TTM) |
returnOnAssetsTTM | number | 0.3303178273265747 | 总资产收益率(ROA,TTM) |
operatingReturnOnAssetsTTM | number | 0.3927775164283649 | 经营性资产收益率(TTM) |
returnOnTangibleAssetsTTM | number | 0.3504666216818967 | 有形资产回报率(TTM) |
returnOnEquityTTM | number | 1.4668924498270723 | 净资产收益率(ROE,TTM) |
returnOnInvestedCapitalTTM | number | 0.49573922251878827 | 投入资本回报率(ROIC,TTM) |
returnOnCapitalEmployedTTM | number | 0.6232675382019193 | 已动用资本回报率(ROCE,TTM) |
earningsYieldTTM | number | 0.025108435518318362 | 盈利收益率(TTM) |
freeCashFlowYieldTTM | number | 0.02650227198117503 | 自由现金流收益率(TTM) |
capexToOperatingCashFlowTTM | number | 0.07878934831909401 | 资本开支对经营现金流比(TTM) |
capexToDepreciationTTM | number | 0.8761300555114988 | 资本开支对折旧比(TTM) |
capexToRevenueTTM | number | 0.02447268973644455 | 资本开支对营收比(TTM) |
salesGeneralAndAdministrativeToRevenueTTM | number | 0.06350095914868355 | 销售管理费用对营收比(TTM) |
researchAndDevelopementToRevenueTTM | number | 0.08868913393082611 | 研发费用对营收比(TTM) |
stockBasedCompensationToRevenueTTM | number | 0.02984436538913083 | 股权激励对营收比(TTM) |
intangiblesToTotalAssetsTTM | number | 0.057491336146727676 | 无形资产对总资产比(TTM) |
averageReceivablesTTM | number | 61915500000 | 平均应收账款(TTM) |
averagePayablesTTM | number | 63968000000 | 平均应付账款(TTM) |
averageInventoryTTM | number | 6311000000 | 平均存货(TTM) |
daysOfSalesOutstandingTTM | number | 43.26472725178429 | 应收账款周转天数(DSO,TTM) |
daysOfPayablesOutstandingTTM | number | 88.93357720364871 | 应付账款周转天数(DPO,TTM) |
daysOfInventoryOutstandingTTM | number | 10.462865008858357 | 存货周转天数(DIO,TTM) |
operatingCycleTTM | number | 53.727592260642645 | 营业周期(TTM) |
cashConversionCycleTTM | number | -35.205984943006065 | 现金转换周期(CCC,TTM) |
freeCashFlowToEquityTTM | number | 114843000000 | 股权自由现金流(FCFE,TTM) |
freeCashFlowToFirmTTM | number | 129174000000 | 公司自由现金流(FCFF,TTM) |
tangibleAssetValueTTM | number | 85157000000 | 有形资产价值(TTM) |
netCurrentAssetValueTTM | number | -120477000000 | 净流动资产价值(TTM) |
查看响应数据示例(原始 JSON)
[
{
"symbol": "AAPL",
"marketCap": 4874072686740,
"enterpriseValueTTM": 4922455686740,
"evToSalesTTM": 10.903849634593149,
"evToOperatingCashFlowTTM": 35.10473168789491,
"evToFreeCashFlowTTM": 38.107170845061695,
"evToEBITDATTM": 30.701642134695508,
"netDebtToEBITDATTM": 0.3017675822667964,
"currentRatioTTM": 1.07035746912159,
"incomeQualityTTM": 1.1439689985723027,
"grahamNumberTTM": 36.83959035988331,
"grahamNetNetTTM": -10.37184248926531,
"taxBurdenTTM": 0.8300602695198754,
"interestBurdenTTM": 1,
"workingCapitalTTM": 9473000000,
"investedCapitalTTM": 80923000000,
"returnOnAssetsTTM": 0.3303178273265747,
"operatingReturnOnAssetsTTM": 0.3927775164283649,
"returnOnTangibleAssetsTTM": 0.3504666216818967,
"returnOnEquityTTM": 1.4668924498270723,
"returnOnInvestedCapitalTTM": 0.49573922251878827,
"returnOnCapitalEmployedTTM": 0.6232675382019193,
"earningsYieldTTM": 0.025108435518318362,
"freeCashFlowYieldTTM": 0.02650227198117503,
"capexToOperatingCashFlowTTM": 0.07878934831909401,
"capexToDepreciationTTM": 0.8761300555114988,内容已截断,完整字段以实际返回为准。
计算口径对照:本接口涉及的TTM 关键财务指标各字段的底层计算公式与原始报表科目映射,可查看 关键财务指标与比率公式大全 →
常见问题解答(FAQ)
2 个问题TTM 关键指标和 关键指标 属于同一模块,两者的查询键与核心产出字段如何区分?
区分方式很简单:需要 marketCap(总市值)和 enterpriseValueTTM(企业价值(EV,TTM))这 43 项字段时请求 /stable/key-metrics-ttm(必填 symbol);需要 Key Metrics(关键指标) 的 47 项字段时请求 /stable/key-metrics(必填 symbol)。
在设计TTM 关键指标(/stable/key-metrics-ttm)的数据拉取管道时,怎样避免单次请求跨度过大或遗漏?
实盘中推荐在 /stable/key-metrics-ttm 中指定 symbol(跨市场代码须保留后缀);通过规范化参数边界,可让 /stable/key-metrics-ttm 稳定产出 marketCap(总市值)等核心业务指标。
同模块相关接口对比
Ratios本接口路径 /stable/key-metrics-ttm,必填参数 symbol。 同一模块「Ratios」下共 4 个接口,下表列出其余 3 个, 按粒度与查询维度对比,避免选错接口。