FMP Ultimate API 中文接口文档（附开箱即用 SDK）

fmpquote 是面向中文量化与金融投研开发者的 Financial Modeling Prep（FMP Ultimate API）轻量级 Python 客户端，底层基于 Python 标准库实现零依赖开箱即用，并支持一键转换为 pandas.DataFrame。

• 中文接口文档总览（283 个接口）：FMP数据源中文站接口中心
• 免费领取个人独享 Key：5分钟快速接入指南
• 财务指标计算公式词典：86条财务指标公式对照表

一、 安装与内置体验 Key

pip install fmpquote
# 如需使用 as_df=True 直接返回 pandas.DataFrame：
pip install "fmpquote[pandas]"

包内已预置 2 把公用 FMP Ultimate 体验 Key，安装后无需注册即可直接调通跨市场示范标的（AAPL、NVDA、TSLA、MSFT、00700.HK、600519.SS、SPY、BTCUSD 等）：

• 默认体验 Key：c9tAmzCerpHeYA9M（默认自动生效）
• 备用体验 Key：RcTN8ECyEECLFEXK（如遇默认 Key 公共额度用满，可通过 FMPClient(api_key="RcTN8ECyEECLFEXK") 传入）

二、 SDK 核心方法参考

from fmpquote import FMPClient, format_cik, normalize_hk_symbol

# 优先级：显式传入 api_key > 环境变量 FMP_API_KEY > 内置默认体验 Key (c9tAmzCerpHeYA9M)
client = FMPClient()

# 1. 获取实时报价（支持 as_df=True 转为 DataFrame）
quote_list = client.quote("NVDA")

# 2. 获取三大财务报表（支持 period="annual" 或 "quarter"）
inc = client.income_statement("AAPL", period="annual", limit=5)
bal = client.balance_sheet("AAPL", period="annual", limit=5)
cf  = client.cash_flow("AAPL", period="annual", limit=5)

# 3. 获取 TTM 财务比率、关键估值指标与 DCF 测算
ratios  = client.ratios_ttm("MSFT")
metrics = client.key_metrics_ttm("MSFT")
dcf_res = client.dcf("AAPL")

# 4. 历史日线、财报电话会议纪要与美债收益率曲线
eod = client.eod_chart("AAPL", from_date="2025-01-01", to_date="2025-10-01")
transcript = client.earnings_transcript("NVDA", year=2025, quarter=4)
treasury = client.treasury_rates()

# 5. 通用 GET 方法：可调用 /stable/ 下全部 283 个端点
holders = client.get(
    "institutional-ownership/extract",
    params={"cik": format_cik(1067983), "year": 2025, "quarter": 2},
)

三、 异常处理与专属 Key 领取

当请求触发网关限制时，SDK 会抛出 FMPAPIError(status_code, message, endpoint) 并原样保留网关返回的双语提示。如需解锁全美股 10,000+ 标的或提升并发配额，请访问 FMP数据源中文站官网。