Key Metrics关键指标
该接口返回公司的核心财务指标,包括营业收入、净利润、市盈率等,可用于快速评估公司表现并与同业对比。
https://quote-fmp.com/stable/key-metrics?symbol=AAPL数据更新周期
Filing Date · 随 SEC 申报日期更新
接口说明
- 营业收入:公司经营活动产生的总收入,反映业务规模,传入
symbol后可获取marketCap(总市值)、enterpriseValue(企业价值(EV))与evToSales(企业价值倍数(EV/Sales)) 等核心要素,减少跨市场数据入库时的字段映射工作。 - 净利润业务定位:扣除全部费用与税项后的利润,反映最终盈利,串联
enterpriseValue(企业价值(EV))与evToSales(企业价值倍数(EV/Sales)) 等返回指标,便于搭建按日或按季刷新的自动化投研看板。 - 市盈率业务定位:股价相对每股盈利的倍数,用来判断估值是偏高还是偏低,针对深度投研场景,搭配同模块的「TTM 关键指标」能进一步拓宽样本对比维度。
- 跨模块关联接口:Latest Financial Statements(最新财务报表) · Income Statements TTM(TTM 利润表) · Financial Estimates(分析师预期查询) · Income Statement Bulk(利润表批量获取)
请求参数
3 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
symbol | string | 必填 | AAPL | 证券代码,例如 AAPL 或 MSFT(美股直传代码如 AAPL;港股/英股/A股须带交易所后缀,如 0700.HK、600519.SS) |
limit | number | 可选 | 5 | 返回结果条数上限,用于控制单次响应大小。 |
period | string | 可选 | Q1,Q2,Q3,Q4,FY,annual,quarter | 报告周期:annual(年度)、quarter(季度)、ttm(滚动十二个月)(单值枚举:常规报表传 annual 或 quarter,Bulk 传 Q1..Q4 或 FY;每次仅传单值) |
调用代码示例
Python 关键代码通过 /stable/key-metrics 检索关键指标(参数:必填 symbol),输出 marketCap(总市值)、enterpriseValue(企业价值(EV))、evToSales(企业价值倍数(EV/Sales))(示例 marketCap=3818743810000)。
resp = requests.get(
"https://quote-fmp.com/stable/key-metrics",
params={"symbol": "AAPL", "limit": 5, "period": "annual", "apikey": FMP_KEY},
timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 按 date 升序重排并数值化 marketCap(总市值)
df["marketCap"] = pd.to_numeric(df["marketCap"], errors="coerce")
df = df.sort_values("date").reset_index(drop=True)参数使用和避坑
3 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法:
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 检索 AAPL 年度周期关键指标明细(annual) | symbol=AAPL&period=annual | 以年报粒度 period=annual 查询 /stable/key-metrics,直接拿到 AAPL 的 marketCap、enterpriseValue、evToSales(样本 marketCap=3818743810000)。 |
| 高频跟踪 AAPL 季度关键指标(quarter) | symbol=AAPL&period=quarter | 指定季报参数 period=quarter,从 /stable/key-metrics 读取 AAPL 最新季度的 marketCap、enterpriseValue、evToSales。 |
| 港股龙头 0700.HK 关键指标采集 | symbol=0700.HK&period=annual | 将 symbol 设为 0700.HK 查询 /stable/key-metrics,实现港股与美股同口径的 marketCap、enterpriseValue、evToSales 比较。 |
/stable/key-metrics(必填 symbol)返回的 marketCap(总市值,样本 3818743810000)与 enterpriseValue 按最新记录置顶;算环比或滚动均值前请先按时间升序重排。
关键指标返回的 marketCap(总市值,示例 3818743810000)在增量同步时,应按 (symbol, date, fiscalYear) 覆盖更新已有记录。
返回数据
47 个字段本接口示例响应共包含 47 个字段(数值型 42 个,文本/日期/布尔型 5 个)。下表列出全部字段名、类型、首条记录真实样本值与中文释义,实际返回会因接口与数据状态有所不同。
展开全部 47 个字段的完整说明
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
symbol | string | "AAPL" | 证券代码 |
date | string | "2025-09-27" | 日期 |
fiscalYear | string | "2025" | 财政年度 |
period | string | "FY" | 报告周期 |
reportedCurrency | string | "USD" | 报告币种(原始财报计价币种;跨国公司对比或与美元市值相除前须先按汇率折算) |
marketCap | number | 3818743810000 | 总市值 |
enterpriseValue | number | 3895186810000 | 企业价值(EV) |
evToSales | number | 9.359807406268247 | 企业价值倍数(EV/Sales) |
evToOperatingCashFlow | number | 34.94005139843203 | 企业价值倍数(EV/OCF) |
evToFreeCashFlow | number | 39.43814037077161 | 企业价值倍数(EV/FCF) |
evToEBITDA | number | 26.969935053694947 | 企业价值倍数(EV/EBITDA) |
netDebtToEBITDA | number | 0.5292846905357032 | 净债务对 EBITDA 比 |
currentRatio | number | 0.8932929222186667 | 流动比率 |
incomeQuality | number | 0.995286135166503 | 盈利质量 |
grahamNumber | number | 28.8371936709443 | 格雷厄姆数 |
grahamNetNet | number | -11.588738000468274 | 格雷厄姆净净值 |
taxBurden | number | 0.8438999766441395 | 税收负担率 |
interestBurden | number | 1 | 利息负担率 |
workingCapital | number | -17674000000 | 营运资本 |
investedCapital | number | 32160000000 | 投入资本 |
returnOnAssets | number | 0.3117962593356549 | 总资产收益率(ROA) |
operatingReturnOnAssets | number | 0.36742927918411644 | 经营性资产收益率 |
returnOnTangibleAssets | number | 0.3117962593356549 | 有形资产回报率 |
returnOnEquity | number | 1.5191298333175105 | 净资产收益率(ROE) |
returnOnInvestedCapital | number | 0.5196842110031786 | 投入资本回报率(ROIC) |
returnOnCapitalEmployed | number | 0.6872062393471412 | 已动用资本回报率(ROCE) |
earningsYield | number | 0.029331635106467118 | 盈利收益率 |
freeCashFlowYield | number | 0.02586374077814872 | 自由现金流收益率 |
capexToOperatingCashFlow | number | 0.11405428679069267 | 资本开支对经营现金流比 |
capexToDepreciation | number | 1.0869379381090785 | 资本开支对折旧比 |
capexToRevenue | number | 0.030553079216937677 | 资本开支对营收比 |
salesGeneralAndAdministrativeToRevenue | number | 0.06632288945864702 | 销售管理费用对营收比 |
researchAndDevelopementToRevenue | number | 0.08302075398703868 | 研发费用对营收比 |
stockBasedCompensationToRevenue | number | 0.030908710811440764 | 股权激励对营收比 |
intangiblesToTotalAssets | number | 0 | 无形资产对总资产比 |
averageReceivables | number | 69600000000 | 平均应收账款 |
averagePayables | number | 69410000000 | 平均应付账款 |
averageInventory | number | 6502000000 | 平均存货 |
daysOfSalesOutstanding | number | 63.9879878220208 | 应收账款周转天数(DSO) |
daysOfPayablesOutstanding | number | 115.40052498189719 | 应付账款周转天数(DPO) |
daysOfInventoryOutstanding | number | 9.445465242577843 | 存货周转天数(DIO) |
operatingCycle | number | 73.43345306459864 | 营业周期 |
cashConversionCycle | number | -41.967071917298554 | 现金转换周期(CCC) |
freeCashFlowToEquity | number | 90284000000 | 股权自由现金流(FCFE) |
freeCashFlowToFirm | number | 98767000000 | 公司自由现金流(FCFF) |
tangibleAssetValue | number | 73733000000 | 有形资产价值 |
netCurrentAssetValue | number | -137551000000 | 净流动资产价值 |
查看响应数据示例(原始 JSON)
[
{
"symbol": "AAPL",
"date": "2025-09-27",
"fiscalYear": "2025",
"period": "FY",
"reportedCurrency": "USD",
"marketCap": 3818743810000,
"enterpriseValue": 3895186810000,
"evToSales": 9.359807406268247,
"evToOperatingCashFlow": 34.94005139843203,
"evToFreeCashFlow": 39.43814037077161,
"evToEBITDA": 26.969935053694947,
"netDebtToEBITDA": 0.5292846905357032,
"currentRatio": 0.8932929222186667,
"incomeQuality": 0.995286135166503,
"grahamNumber": 28.8371936709443,
"grahamNetNet": -11.588738000468274,
"taxBurden": 0.8438999766441395,
"interestBurden": 1,
"workingCapital": -17674000000,
"investedCapital": 32160000000,
"returnOnAssets": 0.3117962593356549,
"operatingReturnOnAssets": 0.36742927918411644,
"returnOnTangibleAssets": 0.3117962593356549,
"returnOnEquity": 1.5191298333175105,
"returnOnInvestedCapital": 0.5196842110031786,
"returnOnCapitalEmployed": 0.6872062393471412,内容已截断,完整字段以实际返回为准。
计算口径对照:本接口涉及的EV/EBITDA、ROIC、自由现金流收益率、研发费用率等指标的计算公式,可查看 关键财务指标与比率公式大全 →
常见问题解答(FAQ)
2 个问题自动化采集中如何搭配调用关键指标(/stable/key-metrics)与同模块的 财务比率?
在「Ratios」模块内,关键指标(/stable/key-metrics,必填 symbol)负责输出 marketCap 与 enterpriseValue 等 47 项指标,Financial Ratios(财务比率)负责输出 66 项指标。
调用 /stable/key-metrics 采集关键指标时,如何设计参数控制与批量请求策略?
工程上推荐通过 /stable/key-metrics 的 limit 参数控制单次返回的历史期数或记录上限;同时复用 requests.Session() 保持 HTTP Keep-Alive,直接提取 marketCap 与 enterpriseValue。
同模块相关接口对比
Ratios本接口路径 /stable/key-metrics,必填参数 symbol。 同一模块「Ratios」下共 4 个接口,下表列出其余 3 个, 按粒度与查询维度对比,避免选错接口。