Enterprise Values企业价值查询
该接口返回公司企业价值(EV)及其构成:市值、总债务与现金及现金等价物,兼顾股权与债务的公司总价值,是评估并购与整体估值的核心指标。
https://quote-fmp.com/stable/enterprise-values?symbol=AAPL数据更新周期
Filing Date · 随 SEC 申报日期更新
接口说明
- 市值:基于当前股价的全部流通股总价值,传入
symbol后可交付stockPrice(股价)、numberOfShares(股数)与marketCapitalization(总市值) 等结构化信息,降低多资产投研系统的数据接入复杂度。 - 债务与现金:计入总债务并扣除现金及现金等价物,完整呈现公司的财务状况,借助
numberOfShares(股数)与marketCapitalization(总市值) 等数值,方便研究员在长周期序列上识别趋势拐点。 - 全面估值:企业价值同时涵盖股权与债务,是评估潜在收购、合并或并购的优先指标,在搭建投研工作流时,建议配合「财务健康评分」同步拉取关联截面数据。
- 配套投研接口:Cashflow Statements TTM(TTM 现金流量表) · Key Metrics(关键指标) · Income Statement Bulk(利润表批量获取) · Earnings Transcript(业绩电话会纪要检索)
请求参数
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/enterprise-values 获取企业价值查询(必填 symbol),DataFrame 包含 stockPrice(股价)、numberOfShares(股数)、marketCapitalization(总市值)(stockPrice=255.46)。
resp = requests.get(
"https://quote-fmp.com/stable/enterprise-values",
params={"symbol": "AAPL", "limit": 5, "period": "annual", "apikey": FMP_KEY},
timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 按 date 升序重排并数值化 stockPrice(股价)
df["stockPrice"] = pd.to_numeric(df["stockPrice"], errors="coerce")
df = df.sort_values("date").reset_index(drop=True)参数使用和避坑
3 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法:
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 请求 AAPL 年度决算企业价值查询(period=annual) | symbol=AAPL&period=annual | 通过 period=annual 从 /stable/enterprise-values 同步 AAPL 年度企业价值查询,涵盖 stockPrice、numberOfShares、marketCapitalization 核心列。 |
| 获取 AAPL 季报口径企业价值查询(period=quarter) | symbol=AAPL&period=quarter | 通过 period=quarter 调用 /stable/enterprise-values,输出 AAPL 季度报告期的 stockPrice、numberOfShares、marketCapitalization 共 8 列。 |
| 跨交易所查询 0700.HK 的企业价值查询 | symbol=0700.HK&period=annual | 指定港股代码 0700.HK 请求 /stable/enterprise-values,返回 stockPrice、numberOfShares、marketCapitalization 等 8 项标准化字段。 |
在量化流水线中调用 /stable/enterprise-values(企业价值查询,必填 symbol),拿到的 stockPrice(255.46)与 marketCapitalization(3818743810000)需先经过非空校验再送入因子矩阵。
/stable/enterprise-values 单行含 8 个属性(如 stockPrice=255.46);PostgreSQL 或 ClickHouse 建表推荐以 (symbol, date) 为排序主键。
返回数据
8 个字段本接口示例响应共包含 8 个字段(数值型 6 个,文本/日期/布尔型 2 个)。下表列出全部字段名、类型、首条记录真实样本值与中文释义,实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
symbol | string | "AAPL" | 证券代码 |
date | string | "2025-09-27" | 日期 |
stockPrice | number | 255.46 | 股价 |
numberOfShares | number | 14948500000 | 股数 |
marketCapitalization | number | 3818743810000 | 总市值 |
minusCashAndCashEquivalents | number | 35934000000 | 减:现金及现金等价物 |
addTotalDebt | number | 112377000000 | 加:债务总额 |
enterpriseValue | number | 3895186810000 | 企业价值(EV) |
查看响应数据示例(原始 JSON)
[
{
"symbol": "AAPL",
"date": "2025-09-27",
"stockPrice": 255.46,
"numberOfShares": 14948500000,
"marketCapitalization": 3818743810000,
"minusCashAndCashEquivalents": 35934000000,
"addTotalDebt": 112377000000,
"enterpriseValue": 3895186810000
}
]计算口径对照:本接口涉及的企业价值(Enterprise Value = 市值 + 总债务 − 现金)及估值公式,可查看 企业价值(EV)与 DCF 计算公式 →
常见问题解答(FAQ)
2 个问题在对接「Analysis」数据线时,企业价值查询与 财务健康评分 各自解决什么问题?
企业价值查询 通过 /stable/enterprise-values(必填 symbol)返回 stockPrice(股价)、numberOfShares(股数)等 8 列明细;同模块的 Financial Scores(财务健康评分) 则通过 /stable/financial-scores(必填 symbol)提供配套数据。
想要完整归档企业价值查询,请求 /stable/enterprise-values 时在参数调度上有什么最佳实践?
在采集 企业价值查询 时,可向 /stable/enterprise-values 传入合适的 limit 容量上限以覆盖目标回测窗口;若遇到休市日或未披露窗口返回 [],脚本应记录水位线并平滑跳过。
同模块相关接口对比
Analysis本接口路径 /stable/enterprise-values,必填参数 symbol。 同一模块「Analysis」下共 3 个接口,下表列出其余 2 个, 按粒度与查询维度对比,避免选错接口。
| 接口 | 路径 | 核心差异与适用场景 |
|---|---|---|
| 财务健康评分Financial Scores | /stable/financial-scores | 通过 Altman Z-Score(Z 值评分)、Piotroski 评分等 |
| 股东盈余(Owner Earnings)Owner Earnings | /stable/owner-earnings | 巴菲特口径的股东盈余序列,以经营现金流扣减维持性资本开支并调整营运资本变动 |