核心结论

FMP 覆盖广、容易测试，但生产可用性取决于套餐权限与数据语义

Financial Modeling Prep 通过 JSON API 提供股票报价、历史价格、公司资料、财务报表、比率、日历、新闻、监管文件等数据。Basic 套餐适合评估和小型个人工作流；商业产品上线前应核对端点权限、历史深度、时效、带宽、展示权和再分发条款。

BEST FOR

原型与金融研究应用

适合希望通过一个 API 覆盖基本面、价格、日历、公司资料和新闻的团队。

CHECK FIRST

套餐权限与授权

不要假设所有文档端点、市场、历史范围或展示用途都包含在每个套餐中。

AGENT RULE

每个结果都保留证据

随数据返回来源、代码、交易所、币种、事件时间、财报期、单位和时效。

谁适合使用 Financial Modeling Prep API？

DEVELOPERS

看板、筛选器与估值工具

需要通过熟悉的 REST 端点获取公司资料、报价、财务报表、指标和日历的团队。

DATA TEAMS

研究与监控管道

构建财报、文件、新闻、价格或基本面定时工作流的分析团队。

AI TEAMS

使用受控工具的金融 Agent

能在模型总结或执行动作前验证结构化结果的 Agent 开发团队。

并非适合所有场景：构建交易执行或公开展示产品时，应单独核对交易所级延迟、逐笔流、授权和再分发权。

Financial Modeling Prep 价格与免费额度

以下个人使用价格和限制于 2026 年 7 月 30 日根据 FMP 官方价格页核验。价格、端点权限和授权可能变化，购买或上线前请再次确认官方页面。

套餐	页面价格	调用限制	适用起点
Basic	免费	250 次/天	测试、学习、个人原型、日终与参考数据
Starter	$22/month*	300 次/分钟	美国基本面、历史价格、新闻、加密货币和外汇
Premium	$59/month*	750 次/分钟	更长历史、更多地区、盘中图表、技术指标和公司日历
Ultimate	$149/month*	3,000 次/分钟	全球覆盖、电话会记录、持仓、批量交付和更深权限

*核验时 FMP 页面展示的是按年计费的月均价格。FMP 还规定滚动 30 天带宽限制，并区分个人和商业使用；展示或再分发 FMP 数据可能需要额外协议。

核对当前 FMP 价格

FMP API 提供哪些数据和端点？

QUOTE

报价与历史价格

Docs

使用报价、批量报价、日终历史和盘中图表端点获取市场快照与时间序列。

验证：场所、延迟、时段、复权

FUNDAMENTALS

财务报表、比率与指标

Docs

获取利润表、资产负债表、现金流量表、关键指标、比率、增长和原始财报数据。

验证：报告期、币种、单位、重述

CALENDARS

财报与公司事件

Docs

跟踪财报、分红、拆股、IPO 和经济数据发布。FMP 的更新周期页列出财报日历约每三小时更新。

验证：时区、公告日期、更新时间

CONTEXT

公司资料、新闻、文件与电话会

Docs

在套餐允许时补充公司身份、市值、行业、新闻、新闻稿、SEC 材料、分析师数据和电话会记录。

验证：来源、发布时间、权限

FMP API 分步接入方法

STEP 1

选择一个 Stable 端点

从公司资料、报价、利润表或财报日历等范围明确的操作开始。

STEP 2

把 API Key 留在服务端

从环境变量读取，并作为 apikey 查询参数发送。

STEP 3

先验证，再规范化

区分 HTTP 错误、FMP 错误响应、空结果、分页不完整和有效记录。

STEP 4

附加证据

保留端点、供应商、请求代码、获取时间、来源时间戳和套餐相关警告。

STEP 5

按数据类别缓存

报价、日历、公司资料、财报和电话会记录不应使用同一个缓存时间。

STEP 6

向 Agent 暴露窄工具

向模型提供类型明确、参数受限的操作，而不是任意 URL 或原始 API Key。

curl "https://financialmodelingprep.com/stable/quote?symbol=AAPL&apikey=YOUR_API_KEY"

const url = new URL("https://financialmodelingprep.com/stable/profile");
url.searchParams.set("symbol", "AAPL");
url.searchParams.set("apikey", process.env.FMP_API_KEY);

const response = await fetch(url, { signal: AbortSignal.timeout(8000) });
if (!response.ok) throw new Error(`FMP HTTP ${response.status}`);

const rows = await response.json();
if (!Array.isArray(rows) || rows.length === 0) {
  throw new Error("FMP returned no company profile");
}

const result = {
  provider: "financial-modeling-prep",
  endpoint: "profile",
  requestedSymbol: "AAPL",
  retrievedAt: new Date().toISOString(),
  data: rows[0]
};

Agent 使用 FMP 数据前的验证清单

检查项	验证内容	忽略后的风险
证券身份	代码、交易所、CIK、证券类型	匹配到错误公司或上市地
时间	事件时间、获取时间、时区、交易时段	把旧数据描述为当前数据
财报期	财年、季度、申报日期、接受日期	混用年度与季度数据
单位	币种、数量级、百分比、每股口径	百万与个位或币种错误
完整性	空值、分页、记录限制、历史窗口	把残缺结果当成完整结果
市场语义	实时或延迟、复权或未复权、场所与覆盖	无效比较和误导性告警

直接接入 FMP、使用 MCP，还是通过 QVeris 路由？

方式	适用情况	需要自行负责
直接调用 FMP API	应用只有一组固定端点和一个主要供应商。	认证、客户端代码、验证、重试、缓存和结构变化。
FMP MCP Server	兼容 MCP 的客户端需要在受控助手工作流中使用 FMP 工具。	服务器运行、凭据、工具结构、策略和供应商错误。
QVeris 能力路由	Agent 需要跨多种金融能力完成发现、检查、比较和调用。	业务策略与验证规则；QVeris 提供统一发现和执行层。

安全、成本与延迟控制

SECURITY

保护密钥并限制工具

把 FMP Key 存放在服务端密钥系统。
对日志中的 URL 和查询参数脱敏。
只允许批准的端点，并限制代码、日期和分页大小。

COST

控制调用量与带宽

缓存变化较慢的公司资料与财报。
仅在套餐和端点允许时批量请求代码。
跟踪每日调用、滚动带宽、重试和响应大小。

LATENCY

按工作流定义时效

为报价、日历、公司资料和财报设置不同 TTL。
设置连接与总超时。
供应商失败后不要静默返回过期缓存。

FMP API 常见故障排查

现象	可能原因	首要动作
401 / 403	Key 无效、端点不可用或套餐限制	在官方文档中测试 Key，并检查端点的套餐权限。
429	达到每日、每分钟或工作流重试限制	停止自动重试，增加退避与缓存，并检查用量。
空数组	代码错误、市场不支持、无记录或历史范围受限	先解析证券身份，再用已知代码和日期测试。
数值不一致	财报期、币种、单位、复权或更新时间不同	先比较原始记录和元数据，不要先改提示词。
Agent 自信地给出错误答案	工具返回数据时缺少证据、警告或验证状态	返回来源和验证字段，验证失败时阻止模型生成结论。