Custom DCF Advanced自定义DCF高级估值
该接口提供高度可配置的企业自由现金流折现(Unlevered DCF / FCFF)交互式估值建模引擎。允许投研人员自主覆写营收增速、EBITDA 利润率、资本开支占比、营运资金周转率、有效税率、永续增长率及加权平均资本成本(WACC)等十余项核心假设,动态输出多期现金流预测表、企业价值与每股内在价值。
https://quote-fmp.com/stable/custom-discounted-cash-flow?symbol=AAPL数据更新周期
N/A · 不适用固定周期
接口说明
- 打破黑盒固定假设、支持全参数覆写:标准静态 DCF 接口使用系统默认的历史外推参数,在面对处于业务转型、新产品放量或宏观加息周期的公司时难免滞后。该接口开放了从损益利润率、折旧摊销、资本开支到无风险利率与 Beta 的全套参数覆写能力,实现“千人千面”的定制化估值。
- 一键开展多情景估值与敏感性压力测试:量化脚本或投研终端可通过网格化调整请求中的“永续增长率”与“WACC 折现率(或无风险利率、市场风险溢价)”参数矩阵,批量调用该接口自动生成经典的“乐观/基准/悲观”三情景估值表与二维敏感性热力图。
- 完整输出逐年现金流预测与终值拆解链路:接口不仅给出最终每股股权价值,还逐年返回预测期内的预计营收、息税前利润、资本开支、自由现金流、终值(Terminal Value)、净债务扣减项及稀释总股本,完整复刻卖方投行深度研报中的 DCF 建模底稿。
- 跨模块关联接口:Cash Flow Statement(现金流量表) · Key Metrics TTM(TTM 关键指标) · Market Risk Premium(市场风险溢价) · Income Statement(利润表)
请求参数
19 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
symbol | string | 必填 | AAPL | 证券代码,例如 AAPL 或 MSFT(美股直传代码如 AAPL;港股/英股/A股须带交易所后缀,如 0700.HK、600519.SS) |
revenueGrowthPct | number | 可选 | 0.1094119804597946 | 预测期年化营收增长率(百分比,可随时间变化)。 |
ebitdaPct | number | 可选 | 0.31273548388 | 预测期 EBITDA 占营收的比例(百分比)。 |
depreciationAndAmortizationPct | number | 可选 | 0.0345531631720999 | 折旧摊销(D&A)占营收的比例(百分比)。 |
cashAndShortTermInvestmentsPct | number | 可选 | 0.2344222126801843 | 现金及短期投资占总资产的比例(百分比)。 |
receivablesPct | number | 可选 | 0.1533770531229388 | 应收账款占营收的比例(百分比)。 |
inventoriesPct | number | 可选 | 0.0155245674227653 | 存货占营收的比例(百分比)。 |
payablePct | number | 可选 | 0.1614868903169657 | 应付账款占营收/成本的比例(百分比)。 |
ebitPct | number | 可选 | 0.2781823207138459 | EBIT 占营收的比例(百分比)。 |
capitalExpenditurePct | number | 可选 | 0.0306025847141713 | 资本开支(Capex)占营收的比例(百分比)。 |
operatingCashFlowPct | number | 可选 | 0.2886333485760204 | 经营现金流占营收的比例(百分比)。 |
sellingGeneralAndAdministrativeExpensesPct | number | 可选 | 0.0662854095187211 | 销售及管理费用(SG&A)占营收的比例(百分比)。 |
taxRate | number | 可选 | 0.14919579658453103 | 预测期适用税率(百分比)。 |
longTermGrowthRate | number | 可选 | 4 | 终值阶段的长期永续增长率(百分比)。 |
costOfDebt | number | 可选 | 3.64 | 债务成本,用于加权平均资本成本计算。 |
costOfEquity | number | 可选 | 9.51168 | 股权成本,用于加权平均资本成本计算。 |
marketRiskPremium | number | 可选 | 4.72 | 市场风险溢价(ERP),权益回报超出无风险利率的部分。 |
beta | number | 可选 | 1.244 | 股票 Beta 系数,衡量系统性风险。 |
riskFreeRate | number | 可选 | 3.64 | 无风险利率,通常取长期国债收益率。 |
调用代码示例
Python 关键代码请求 /stable/custom-discounted-cash-flow 拉取自定义DCF高级估值(必填 symbol),可直取 year(年份)、revenue(营业收入)、revenuePercentage(营业收入占比(%))(如 year=2030)共 47 项。
resp = requests.get(
"https://quote-fmp.com/stable/custom-discounted-cash-flow",
params={"symbol": "AAPL", "revenueGrowthPct": "0.1094119804597946", "ebitdaPct": "0.31273548388", "depreciationAndAmortizationPct": "0.0345531631720999", "apikey": FMP_KEY},
timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 数值化核心指标列 revenue(营业收入)
df["revenue"] = pd.to_numeric(df["revenue"], errors="coerce")参数使用和避坑
2 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法:
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 单票检索 AAPL 的自定义DCF高级估值数据 | symbol=AAPL | 在 /stable/custom-discounted-cash-flow 中锁定 AAPL,返回 自定义DCF高级估值 对应的 year、revenue、revenuePercentage 明细列表。 |
| 非美交易所标的(symbol=0700.HK)查询自定义DCF高级估值 | symbol=0700.HK | 向 /stable/custom-discounted-cash-flow 传带交易所后缀的 symbol=0700.HK,拉取非美标的的 year、revenue、revenuePercentage 明细。 |
自定义DCF高级估值由 /stable/custom-discounted-cash-flow 承载(必填 symbol),核心列包括 year(年份,样本 2030);查询非美标的时请确认交易所后缀格式正确。
将自定义DCF高级估值(/stable/custom-discounted-cash-flow)落库时,建议以 (symbol) 建唯一索引;核心列 revenue(营业收入,样本 529528728806)宜转为 float64 处理。
返回数据
47 个字段本接口示例响应共包含 47 个字段(数值型 45 个,文本/日期/布尔型 2 个)。下表列出全部字段名、类型、首条记录真实样本值与中文释义,实际返回会因接口与数据状态有所不同。
展开全部 47 个字段的完整说明
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
year | string | "2030" | 年份 |
symbol | string | "AAPL" | 证券代码 |
revenue | number | 529528728806 | 营业收入 |
revenuePercentage | number | 4.09 | 营业收入占比(%) |
ebitda | number | 191125428209 | 息税折旧摊销前利润(EBITDA) |
ebitdaPercentage | number | 36.09 | EBITDA 占比(%) |
ebit | number | 177353356628 | 息税前利润(EBIT) |
ebitPercentage | number | 33.49 | EBIT 占比(%) |
depreciation | number | 15508463644 | 折旧 |
depreciationPercentage | number | 2.93 | 折旧占比(%) |
totalCash | number | 79685715467 | 现金总额 |
totalCashPercentage | number | 15.05 | 现金占比(%) |
receivables | number | 114078294622 | 应收账款 |
receivablesPercentage | number | 21.54 | 应收账款占比(%) |
inventories | number | 8411056160 | 存货 |
inventoriesPercentage | number | 1.59 | 存货占比(%) |
payable | number | 101862682518 | 应付账款 |
payablePercentage | number | 19.24 | 应付账款占比(%) |
capitalExpenditure | number | -14907445037 | 资本开支 |
capitalExpenditurePercentage | number | -2.82 | 资本开支占比(%) |
price | number | 331.86 | 最新价 |
beta | number | 1.097 | Beta 系数 |
dilutedSharesOutstanding | number | 15004697000 | 摊薄发行在外股本 |
costofDebt | number | 4.37 | 债务成本 |
taxRate | number | 15.61 | 税率 |
afterTaxCostOfDebt | number | 3.69 | 税后债务成本 |
riskFreeRate | number | 4.37 | 无风险利率 |
marketRiskPremium | number | 4.72 | 市场风险溢价 |
costOfEquity | number | 9.55 | 股权成本 |
totalDebt | number | 112377000000 | 债务合计 |
totalEquity | number | 4979383872981 | 权益合计 |
totalCapital | number | 5091760872981 | 资本总额 |
debtWeighting | number | 2.21 | 债务权重 |
equityWeighting | number | 97.79 | 权益权重 |
wacc | number | 9.42 | 加权平均资本成本(WACC) |
taxRateCash | number | 16785417 | 现金税率 |
ebiat | number | 147583856418 | 息前税后利润(EBIAT) |
ufcf | number | 145836268225 | 无杠杆自由现金流(UFCF) |
sumPvUfcf | number | 499614640480 | 无杠杆自由现金流现值合计 |
longTermGrowthRate | number | 4 | 长期增长率 |
terminalValue | number | 2799690706080 | 终值 |
presentTerminalValue | number | 1785166037885 | 终值现值 |
enterpriseValue | number | 2284780678366 | 企业价值(EV) |
netDebt | number | 76443000000 | 净债务 |
equityValue | number | 2208337678366 | 股权价值 |
equityValuePerShare | number | 147.18 | 每股股权价值 |
freeCashFlowT1 | number | 151669718954 | 自由现金流(T1) |
查看响应数据示例(原始 JSON)
[
{
"year": "2030",
"symbol": "AAPL",
"revenue": 529528728806,
"revenuePercentage": 4.09,
"ebitda": 191125428209,
"ebitdaPercentage": 36.09,
"ebit": 177353356628,
"ebitPercentage": 33.49,
"depreciation": 15508463644,
"depreciationPercentage": 2.93,
"totalCash": 79685715467,
"totalCashPercentage": 15.05,
"receivables": 114078294622,
"receivablesPercentage": 21.54,
"inventories": 8411056160,
"inventoriesPercentage": 1.59,
"payable": 101862682518,
"payablePercentage": 19.24,
"capitalExpenditure": -14907445037,
"capitalExpenditurePercentage": -2.82,
"price": 331.86,
"beta": 1.097,
"dilutedSharesOutstanding": 15004697000,
"costofDebt": 4.37,
"taxRate": 15.61,
"afterTaxCostOfDebt": 3.69,内容已截断,完整字段以实际返回为准。
计算口径对照:本接口涉及的自定义营收增速、税率、资本开支占比、Beta 与 WACC 的完整 DCF 公式,可查看 自定义高级 DCF 估值公式 →
常见问题解答(FAQ)
2 个问题如何用自定义 DCF 对同一家公司比较两组假设?
先固定 symbol 取得基准结果,再仅调整一个模型参数,例如 revenueGrowthPct 或 longTermGrowthRate,保存每次完整参数与结果作对照。一次改变多个参数就无法归因估值变化;结果属于相应假设下的模型输出,不是市场成交价或收益保证。
如何确保从 /stable/custom-discounted-cash-flow 拉取的自定义DCF高级估值覆盖完整目标区间且不触发空跑?
为保障采集稳定性,请按标的代码 symbol 请求 /stable/custom-discounted-cash-flow(非美标的需附交易所后缀);并针对 /stable/custom-discounted-cash-flow 返回的 year(如 2030)建立自动化数据质量断言。
同模块相关接口对比
Dcf本接口路径 /stable/custom-discounted-cash-flow,必填参数 symbol。 同一模块「Dcf」下共 4 个接口,下表列出其余 3 个, 按粒度与查询维度对比,避免选错接口。
| 接口 | 路径 | 核心差异与适用场景 |
|---|---|---|
| DCF 估值DCF Valuation | /stable/discounted-cash-flow | 基于自由现金流折现标准模型,返回指定上市公司的最新每股内在价值测算值及同期二级市场实时股价 |
| 杠杆 DCF 估值Levered DCF | /stable/levered-discounted-cash-flow | 基于计入债务杠杆与利息税盾效应的股权自由现金流模型 |
| 自定义杠杆DCF估值Custom DCF Levered | /stable/custom-levered-discounted-cash-flow | 支持全参数自定义的杠杆现金流折现高级估值引擎 |