Economics（宏观经济）

Q: 宏观指标支持哪些名称？

用 Economics Indicators（经济指标数据） 的 name 参数指定，如 GDP、CPI、unemploymentRate 等，先小范围试查确认可用性。

Q: 如何用宏观经济接口计算美债期限利差（如 10Y-2Y）与 DCF 折现率？

先调用 Treasury Rates（国债收益率）获取同一交易日的 year10 与 year2 相减即得 10Y-2Y 期限利差；再将 year10（无风险利率）与 Market Risk Premium（市场风险溢价）返回的 totalEquityRiskPremium 结合即可构建权益资本成本（Ke）。

此类接口提供宏观与利率信息，包括美国国债收益率曲线、各类经济指标的历史序列、数据发布日历，以及股票市场风险溢价。做自上而下的资产配置、给 DCF 取无风险利率，或提前知道本周有哪些重要数据要公布，都可以从这里取数；指标口径与发布频率以官方统计为准。

典型使用场景

4 个场景

折现率构建

用对应期限的国债收益率作为无风险利率。

宏观择时研究

把指标时间序列与指数收益对齐做检验。

事件窗口排程

按发布日历安排数据刷新与策略开关。

收益率曲线倒挂监控

实时计算 10Y-2Y 与 10Y-3M 美债利差，跟踪衰退预警信号。

接口怎么选？

4 项选型对照

宏观类别给市场数据提供背景：无风险利率用国债收益率，周期位置用宏观指标，事件窗口看发布日历，估值折现用风险溢价。

宏观数据有初值与修正值之分，同一期数据在不同时间点可能不一样。做回测时不能只用最新修订后的版本，否则会引入未来信息。

你的需求	推荐接口	选择理由
取无风险利率或画收益率曲线	Treasury Rates美国国债收益率	按期限给出美国国债收益率
查 GDP、CPI、失业率等指标	Economics Indicators经济指标数据	按指标名与区间取时间序列
知道宏观数据哪天发布	Economic Data Releases Calendar经济数据日历	用于事件交易与数据更新排程
估算股权风险溢价	Market Risk Premium市场风险溢价	DCF 折现率里的 ERP 参数来源

数据覆盖与参数口径

地域范围：以美国宏观数据为主，其他经济体覆盖有限
频率：日频（利率）到月度、季度（宏观指标）
修正机制：宏观指标存在初值与多轮修正，历史值会变化
发布时点：发布日历按美国东部时间；换算到本地时区要处理夏令时
风险溢价：ERP 是估算值，依赖模型假设，不等于可直接交易的指标
核心返回字段：美债含 date、month1..year30；宏观指标含 name、date、value；风险溢价含 country、totalEquityRiskPremium
入库幂等主键：美债按 date 唯一；宏观指标按 (name, date) 唯一；风险溢价按 (country, snapshotDate) 唯一

调用示例

Python 关键代码

示例场景：按区间取国债收益率 · 对应接口：Treasury Rates（美国国债收益率）

Python（核心参数与字段清洗逻辑）

resp = requests.get(
    "https://quote-fmp.com/stable/treasury-rates",
    params={"from": "2026-01-27", "to": "2026-04-27", "apikey": FMP_KEY},
    timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 按 date 升序重排并数值化 month1（1 月期）
df["month1"] = pd.to_numeric(df["month1"], errors="coerce")
df = df.sort_values("date").reset_index(drop=True)

做折现时明确用哪个期限，短端与长端差异很大。
收益率是百分比数值，别当成小数比例再除一次 100。

数据注意事项

4 条实盘要点

Treasury Rates（美国国债收益率）按交易日横向返回 month1 至 year30 共 12 个期限点的美债收益率（百分比值，如 4.25 代表 4.25%），计算期限利差前先检查短端是否缺失。
调用 Economics Indicators（经济指标数据）时通过 name 参数指定宏观序列（如 GDP、CPI、unemploymentRate、federalFunds），注意区分同比与环比口径。
Economic Data Releases Calendar（经济数据日历）的发布时间采用美国东部时间，跨时区实盘风控需处理北美冬令时/夏令时（EST/EDT）1 小时偏移。
Market Risk Premium（市场风险溢价）提供按国家/地区划分的股权风险溢价（totalEquityRiskPremium 与 countryRiskPremium），可直接作为跨国 DCF 模型的折现率输入。

常见问题

4 个问题

为什么同一期 GDP 的数值会变？

宏观统计有初值、修订值与终值。做历史分析时应使用当时的初值，用最新修订值回测会引入未来信息。

国债收益率是百分比还是小数？

返回的是百分比数值（如 4.25 表示 4.25%），计算时不要再除以 100。

宏观指标支持哪些名称？

用 Economics Indicators（经济指标数据）的 name 参数指定，如 GDP、CPI、unemploymentRate 等，先小范围试查确认可用性。

如何用宏观经济接口计算美债期限利差（如 10Y-2Y）与 DCF 折现率？

先调用 Treasury Rates（国债收益率）获取同一交易日的 year10 与 year2 相减即得 10Y-2Y 期限利差；再将 year10（无风险利率）与 Market Risk Premium（市场风险溢价）返回的 totalEquityRiskPremium 结合即可构建权益资本成本（Ke）。

接口一览（4个）

1 个功能模块

Economics Data

4 个接口

GETTreasury Rates

美国国债收益率

该接口按自定义起止日期区间返回美国国债全期限收益率曲线（Yield Curve）的每日历史与最新数据。单条记录完整对齐从 1 个月、3 个月、6 个月短端国库券，到 1 年、2 年、5 年、7 年、10 年中端国债，直至 20 年、30 年超长端国债的各期限到期收益率，是全球资产定价的无风险利率基准。

/stable/treasury-rates

GETEconomics Indicators

经济指标数据

该接口按宏观指标名称与日期区间，返回美国核心宏观经济指标的官方历史与最新时间序列数据。覆盖实际与名义 GDP、CPI 通胀率、失业率、非农就业人口、零售销售、联邦基金利率、工业产出、消费者信心指数及房屋开工等二十余项重磅宏观序列，是自上而下（Top-Down）宏观量化研究的数据底座。

/stable/economic-indicators

GETEconomic Data Releases Calendar

经济数据日历

该接口按自定义起止日期区间返回全球主要经济体即将发布或已发布的宏观经济数据日历流水。每条记录详列具体发布时间戳、国家与货币代码、经济事件名称、官方影响重要度分级，以及前值、市场一致预期值、实际公布值与变动幅度，是宏观事件交易与跨市场风控的核心日历。

/stable/economic-calendar

GETMarket Risk Premium

市场风险溢价

该接口返回全球各国家与地区的股权市场风险溢价（Market Risk Premium），涵盖国家风险溢价与无风险利率之差，是 CAPM 权益资本成本（Ke）与 WACC 贴现率建模的核心输入参数。