fmp-api

用途

Financial Modeling Prep（FMP）API 是一套综合性金融数据接口，主要用于获取股票行情、公司基本面、SEC 文件、机构持仓（13F）、国会交易数据以及预计算估值。适合需要以编程方式访问财务数据、进行基本面分析或构建金融数据应用的场景。

主要能力

该 API 覆盖多个数据类别：

股票报价与价格：/quote（实时报价）、/quote-short（快速价格）、/historical-price-eod/full（历史日终数据）、/historical-price-intraday（盘中价格，付费）、/pre-post-market-quote（盘前盘后，付费）。
财务报表：/income-statement（利润表）、/balance-sheet-statement（资产负债表）、/cash-flow-statement（现金流量表）、/income-statement-growth（利润增长）、/key-metrics（关键指标）、/financial-ratios（财务比率）、/enterprise-values（企业价值）。
估值与分析：/discounted-cash-flow（DCF 估值）、/historical-discounted-cash-flow（历史 DCF）、/rating（公司评级）、/historical-rating（评级历史）、/company-outlook（完整公司数据）。
机构与内部人数据：/institutional-holder（机构持有者，付费）、/mutual-fund-holder（共同基金持有者，付费）、/insider-trading（内部人交易，付费）、/form-13f（13F 文件，付费）、/senate-trading（参议院交易，付费）、/house-trading（众议院交易，付费）。
筛选与发现：/stock-screener（股票筛选器，付费）、/stock-grade（股票评级）、/search（按代码搜索）、/search-name（按名称搜索）、/profile（公司概况）。
日历与事件：/earnings-calendar（财报日期）、/ipo-calendar（IPO 日期）、/stock-dividend-calendar（股息）、/stock-split-calendar（拆股）、/economic-calendar（经济事件）。
SEC 文件：/sec-filings（所有 SEC 文件）、/rss-feed-sec-filings（SEC RSS 订阅）。

使用方式

认证通过环境变量配置：

export FMP_API_KEY="your_api_key"

或在 .env 文件中设置 FMP_API_KEY=your_api_key。

基础调用示例（Python）：

import requests import os

API_KEY = os.getenv("FMP_API_KEY") BASE_URL = "https://financialmodelingprep.com/stable"

def get_quote(symbol: str) -> dict: response = requests.get( f"{BASE_URL}/quote", params={"symbol": symbol, "apikey": API_KEY} ) data = response.json() return data[0] if data else {}

注意：FMP 已迁移到 /stable/ 端点，旧版 /api/v3/ 端点需要已有订阅。

官方推荐的 Python 封装安装方式：

pip install --upgrade FinancialModelingPrep-Python

from fmp_python.fmp import FMP fmp = FMP(api_key="your_api_key") profile = fmp.get_company_profile("AAPL")

适用场景

获取公司财务报表、关键指标与比率，用于基本面分析。
获取预计算 DCF 估值，快速评估公司内在价值。
查询公司概况、财报日历、历史价格和 SEC 文件列表。
搜索公司代码或名称，发现标的。
在付费层获取机构持仓、13F、内幕交易和国会交易数据。

限制

免费层限制：每天 250 次调用；约 100 个样本符号（如 AAPL、TSLA、AMZN 等）；仅日终数据；500MB 带宽（30 天滚动）。

付费层：Starter 每月 22 美元，无限调用、每分钟 300 次；Premium 每月 59 美元，每分钟 750 次；Ultimate 每月 149 美元，每分钟 3,000 次。付费层逐步解锁无限符号、盘中数据、股票筛选器、国际股票、机构持有者、共同基金持有者、ETF 持仓明细、13F 文件、内幕交易、国会交易、分析师估计、财报电话会议记录、盘前盘后数据等。

其他限制：免费层调用次数消耗较快，建议缓存静态数据（如公司概况、历史数据），存储财务报表（仅按季度更新），并优先使用 /company-outlook 单次调用获取全部数据。

技能介绍

用途

主要能力

使用方式

适用场景

限制

相关技能