Economics Indicators经济指标数据
该接口按宏观指标名称与日期区间，返回美国核心宏观经济指标的官方历史与最新时间序列数据。覆盖实际与名义 GDP、CPI 通胀率、失业率、非农就业人口、零售销售、联邦基金利率、工业产出、消费者信心指数及房屋开工等二十余项重磅宏观序列，是自上而下（Top-Down）宏观量化研究的数据底座。
https://quote-fmp.com/stable/economic-indicators?name=GDP数据更新周期
4 Hours
接口说明
- 美林投资时钟象限量化划分底座：通过按需拉取 GDP 增速、工业产出、非农就业与 CPI／PCE 通胀时间序列，宏观策略团队可构建量化的“经济增长因子”与“通胀压力因子”，自动判定当前宏观环境处于复苏、过热、滞胀还是衰退象限，指导大类资产超低配。
- 跨周期基本面回测的宏观外生变量输入：在开展长达十余年的行业轮动或信用利差回测时，可将联邦基金有效利率、30 年固定抵押贷款利率、商业银行最优惠利率或汽车销量、新屋开工等序列作为行业景气度先行指标，挖掘宏观变量对地产、汽车及消费板块的领先传导规律。
- 统一标准格式的宏观指标时间序列：以往采集宏观数据需分别对接美联储（FRED）、劳工统计局（BLS）与经济分析局（BEA）等多个异构网站。该接口将数十项核心宏观经济序列统一封装为极简的“日期＋数值”时间序列格式，大幅简化宏观数据库（Macro DB）的日常维护。
- 跨模块关联接口：Market Sector Performance Snapshot（板块表现快照） · S&P 500 Index（标普500成分股） · Commodities Quote（大宗商品报价） · Forex Quote（外汇实时报价）
请求参数
3 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
name | string | 必填 | GDP,realGDP,nominalPotentialGDP,realGDPPerCapita,federalFunds,CPI,inflationRate,inflation,retailSales,consumerSentiment,durableGoods,unemploymentRate,totalNonfarmPayroll,initialClaims,industrialProductionTotalIndex,newPrivatelyOwnedHousingUnitsStartedTotalUnits,totalVehicleSales,retailMoneyFunds,smoothedUSRecessionProbabilities,3MonthOr90DayRatesAndYieldsCertificatesOfDeposit,commercialBankInterestRateOnCreditCardPlansAllAccounts,30YearFixedRateMortgageAverage,15YearFixedRateMortgageAverage,tradeBalanceGoodsAndServices | 公司或证券名称关键词，用于按名称检索。 |
from | date | 可选 | 2025-04-27 | 查询起始日期，格式 YYYY-MM-DD，包含当天。 |
to | date | 可选 | 2026-04-27 | 查询结束日期，格式 YYYY-MM-DD，包含当天。 |
调用代码示例
Python 关键代码经济指标数据由 /stable/economic-indicators 提供（必填 name），明细涵盖 name（名称）、value（数值）、date（日期） 等 3 列。
resp = requests.get(
"https://quote-fmp.com/stable/economic-indicators",
params={"name": "GDP", "from": "2025-04-27", "to": "2026-04-27", "apikey": FMP_KEY},
timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 按 date 升序重排并数值化 value（数值）
df["value"] = pd.to_numeric(df["value"], errors="coerce")
df = df.sort_values("date").reset_index(drop=True)参数使用和避坑
2 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法：
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 按 2025 一季度区间（from/to）查询经济指标数据 | name=GDP&from=2025-01-01&to=2025-03-31 | 设定 2025Q1 起止日期调用 /stable/economic-indicators，返回窗口内全部 name、value、date 共 3 列事件记录。 |
| 回溯 2024H2 日期区间（from/to）归档经济指标数据 | name=GDP&from=2024-07-01&to=2024-12-31 | 将日期窗口移至 2024 下半年调用 /stable/economic-indicators，批量回填历史截面的 name、value、date（样本 GDP）。 |
解析 /stable/economic-indicators 产出的经济指标数据（必填 name）时，注意 name（如 GDP）在历史早期截面可能为 null，下游计算前需做空值过滤。
本地维护经济指标数据底表（源自 /stable/economic-indicators）时，主键定为 (date, name)；读取 value（数值，样本 31422.526）做横截面标准化前先剔除 NaN。
返回数据
3 个字段本接口示例响应共包含 3 个字段（数值型 1 个，文本/日期/布尔型 2 个）。下表列出全部字段名、类型、首条记录真实样本值与中文释义，实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
name | string | "GDP" | 名称 |
date | string | "2025-10-01" | 日期 |
value | number | 31422.526 | 数值 |
查看响应数据示例（原始 JSON）
[
{
"name": "GDP",
"date": "2025-10-01",
"value": 31422.526
}
]常见问题解答（FAQ）
2 个问题在实际量化建模中，经济指标数据与 美国国债收益率（/stable/treasury-rates）是如何互补联动的？
向 /stable/economic-indicators 请求经济指标数据需遵循必填 name，返回 name（名称，样本 GDP）等 3 项；而 Treasury Rates（美国国债收益率）遵循无必填参数并返回 13 项。
回测需要多期或多标的经济指标数据，调用 /stable/economic-indicators 应该如何组织请求？
您可以指定起止日期 from/to 分段同步 /stable/economic-indicators；在落盘 经济指标数据 的 name 与 value 时，建议将原始响应分批转换为列式存储。
同模块相关接口对比
Economics Data本接口路径 /stable/economic-indicators，必填参数 name。 同一模块「Economics Data」下共 4 个接口，下表列出其余 3 个， 按粒度与查询维度对比，避免选错接口。