QVeris
金融数据 · FMP × QVERIS

在 QVeris 中,将 FMP 数据用于 AI 智能体工作流

聚焦盈利研究的实操演练:通过 QVeris,串联 Apple 的财务业绩、管理层解释与财报前后股价,形成可追溯的研究答案。

· 待发布稿 · QVeris团队制作

摆有财务报表和笔记本电脑的金融研究桌面,概念配图。
APPLE · 2025 财年第一季度
看懂盈利,再看市场反应。

财务数据 → 管理层解释 → 股价窗口

围绕一个季度,回答一个研究问题

Apple 2025 财年第一季度的稀释 EPS 为什么比收入增长更快?财报后的首个交易日,股价最终收涨了吗?仅凭一条报价或财报标题不足以回答。本文跟踪截至 2024 年 12 月 28 日的季度、2025 年 1 月 30 日的业绩发布,以及前后的交易日。

实测结果是:收入同比增长 3.95%、净利润增长 7.12%、稀释 EPS 增长 10.09%;毛利率上升,稀释加权平均股数下降。1 月 31 日的开盘价较前收盘高 4.04%,收盘却下跌 0.67%。开盘反应与收盘结果并不相同。

Financial Modeling Prep(FMP)提供金融与市场数据集,QVeris让智能体发现并调用相关工具。智能体负责对齐报告期、计算变化并形成解读,研究者核对证据。这是一个已完成报告期的历史案例,不是对 Apple 当前股价的建议。

三个数据集,共同补齐研究答案

证据回答什么单独无法证明什么
利润表同口径季度的收入、利润、利润率及稀释股数。每项变化背后的业务原因。
财报电话会议记录管理层解释、发言人及未来展望。对管理层说法的独立验证。
日线价格与成交量财报前后的交易表现。盘后成交或财报对股价的因果影响。

用公司、财年季度和事件日期连接三类数据。不要直接用财务报表的期末日划定交易窗口:本季 12 月 28 日结束,财报在 1 月 30 日发布。电话会议为数字补充背景,价格数据说明市场实际发生了什么。

通过 QVeris 调用 FMP 数据开展盈利研究

本案例通过 QVeris 获取 FMP 利润表、财报电话会议记录和历史股价,三类数据均已成功返回,并保留了请求参数与执行记录供核对。下文基于这些结果展开分析;重新调用时,返回值可能因数据商修订而发生变化。

  1. 使用下方聊天框在当前页面运行案例,或按照MCP 配置文档连接智能体。使用 Python 时,获取 QVeris API Key,并在服务端设置 QVERIS_API_KEY 环境变量。
  2. 发现下表中的三个 FMP 能力;参数或访问条件不明确时,检查当前工具契约。本次目录显示每次调用 24.2 credits,这是测试时的目录价格,不代表未来费用承诺。参阅当前定价,实际结算以 Usage 为准。
  3. 运行提示词,逐项检查返回值后再计算。本次 QVeris 路径只使用了 QVeris Key,没有另传 FMP Key。直接接入 FMP 则有自己的认证和套餐要求。目录中存在工具,不代表每个账户或报告期都可访问。
QVeris 工具本次实际参数
Income Statement{"symbol":"AAPL","period":"quarter","limit":16}
Earnings Transcript{"symbol":"AAPL","year":"2025","quarter":"1"}
Full Chart{"symbol":"AAPL","from":"2025-01-27","to":"2025-02-05"}

利润表接口返回最近若干条记录,取回后应按准确财年和季度筛选,不能默认第一条就是目标季度。如果日后重跑的结果不再覆盖两个比较期,应在当前接口允许范围内提高 limit。

在当前页面对话,完成盈利研究

直接在这里提出研究问题。QVeris 可以获取 FMP 财报、电话会议记录与历史股价,并在当前对话中解释结果。

QVeris Chat
对话服务待接入

使用已连接账户的积分,工具结果附来源信息。

Enter 发送 · Shift + Enter 换行
PYTHON

使用 Python 调用相同数据

使用 Python 3.10+ 标准库,随页面包下载 reproduce.py,可先校验已有数据,再执行真实请求。

1. 运行示例

第一条命令重算保存的数据。使用 --live 前,在服务端设置 QVERIS_API_KEY;真实请求可能消耗积分。

TERMINAL
python3 examples/reproduce.py

python3 examples/reproduce.py --live

2. 查看请求参数

调用电话会议记录时,使用你本次工具发现返回的 search_id,并填写下方财年与季度。

JSON · REQUEST
{
  "search_id": "<from your discovery>",
  "parameters": {
    "symbol": "AAPL",
    "year": "2025",
    "quarter": "1"
  },
  "max_response_size": -1
}

请求使用 Bearer 认证。脚本检查 HTTP 与上游错误,拒绝空数据及错期数据,并设置 5 秒请求超时。发生超时后,应先核对 Usage 再决定是否重试。

Apple 披露的业绩发生了什么变化?

经 FMP 获取的披露数字。下表金额合计以十亿美元计,EPS 以美元/股计。FY2025 Q1(截至 2024-12-28)与 FY2024 Q1(截至 2023-12-30)比较,避免与不含同一节日销售季的上一季度混比。关键合计数也已对照Apple 合并财务报表核验。

指标FY2024 Q1FY2025 Q1同比,计算值
收入119.575124.300+3.95%
毛利润54.85558.275+6.23%
营业利润40.37342.832+6.09%
净利润33.91636.330+7.12%
稀释 EPS(美元/股)2.182.40+10.09%
稀释加权平均股数(十亿股)15.57664115.150865−2.73%

计算结果:毛利率从 45.87% 升至 46.88%,提高 1.01 个百分点。收入增长和毛利率上升使毛利润增加 34.20 亿美元;营业费用增加 9.61 亿美元,因此营业利润增加 24.59 亿美元。净利润增速还受到非经营项目和税项影响。

AI 解读:利润增长解释了 EPS 增长的一部分,稀释股数减少也有贡献。近似关系为 EPS = 净利润 ÷ 稀释加权平均股数。用已四舍五入的披露 EPS 计算,增幅为 10.09%。此处应使用稀释加权平均股数计算,而非期末流通股数。

实际返回值节选

以下为成功返回的 Income Statement 数据中的部分字段,金额保持原始美元单位,不是模拟结果。

JSON
{
  "date": "2024-12-28",
  "symbol": "AAPL",
  "reportedCurrency": "USD",
  "fiscalYear": "2025",
  "period": "Q1",
  "revenue": 124300000000,
  "grossProfit": 58275000000,
  "netIncome": 36330000000,
  "epsDiluted": 2.4
}

公式:同比 =(本期 ÷ 上期 − 1)× 100%;毛利率 = grossProfit ÷ revenue × 100%。仅在展示时四舍五入。

高开,并不意味着收盘上涨

依据Apple 业绩公告,发布日为 1 月 30 日,会议安排在太平洋时间下午 2 点/美东时间下午 5 点,位于常规交易时段之后。本文以 1 月 30 日的常规收盘价为基准,1 月 31 日为发布后首个交易日。利润表中 1 月 31 日的 filingDate 是另一种日期字段。

交易日期事件位置开盘,美元收盘,美元成交量,百万股
2025-01-29发布前234.12239.3645.49
2025-01-30发布日/基准收盘238.67237.5955.66
2025-01-31发布后首个交易日247.19236.00101.08
2025-02-03第二个交易日229.99228.0173.06
2025-02-04第三个交易日227.25232.8045.07
2025-02-05第四个交易日228.53232.4739.66
+4.04%次日开盘相对基准收盘
−0.67%次日收盘相对基准收盘
−2.15%第四个交易日收盘相对基准

计算分别为 247.19 / 237.59 − 1、236.00 / 237.59 − 1 和 232.47 / 237.59 − 1。1 月 31 日成交量约为 1 月 30 日的 1.82 倍,但单个前交易日不能代表历史平均成交量。

一个字段陷阱:1 月 31 日返回的 changePercent: -4.53 与当日开盘到收盘的跌幅一致,并非本文需要的 −0.67% 收盘对收盘收益率。应根据明确的价格字段计算研究窗口,而不是直接照抄名称含糊的百分比。

这些是 Full Chart 接口返回的日线价格,不是含股息的总回报。响应没有复权标志、币种字段或时区;美元及美国交易日口径来自标的与来源背景。延长窗口前应确认公司行动及当前复权规则。日线无法还原盘后成交路径,本案例也没有用市场基准或新闻控制变量隔离财报影响。

让研究答案保留可追溯的证据

记录数值或规则
财务报告期FY2025 Q1 · 2024-12-28 / FY2024 Q1 · 2023-12-30
财报发布与会议2025-01-30 · Apple 公告
取数记录工具 ID、请求参数与执行 ID 保留在可下载的证据文件中。
财务单位原始报表:美元;表格:十亿美元;EPS:美元/股。
价格窗口规则以 2025-01-30 收盘为基准;按日期升序;不填充非交易日。
证据下载经核验字段节选与 execution_id

每次保存的执行均含工具 ID、请求参数、抓取时间和 execution_id。将披露数值、注明发言人的评述、计算结果与 AI 解读分别存放,不能把 AI 总结当作管理层原话。

本案例使用保存的数据重建历史,不是对财报发布当时可获信息的时点回测。历史报表与记录可能修订。本案例未获取分析师一致预期、市场基准或分部接口,因此不能据此认定业绩超预期,或计算经过市场调整的因果收益。

常见问题

需要单独订阅 FMP 吗?

本次测试仅使用 QVeris 认证。你的访问条件与费用取决于当前 QVeris 工具和账户。直接调用 FMP API 遵循 FMP 自身套餐,其权益不会自动转移至 QVeris。

电话会议记录缺失怎么办?

说明缺失的公司和报告期,只继续证据支持的部分。检查记录可用性,或使用明确标注的公司原始来源。不能编造引述,也不能把其他来源标为 FMP 返回结果。

同一工作流能判断业绩是否超预期吗?

需补充一致预期数据,并保留预期的观察时间、可比会计口径及财务报告期。实际业绩增长不等于超预期;应固定发布前的预期快照,再与披露业绩比较。

查看本案例使用的工具与官方文档

点击 QVeris 工具入口,可查看参数并使用对应数据;点击 FMP 官方文档,可了解接口定义和字段说明。下列链接与本文使用的三个数据集一一对应。

季度利润表

对比不同报告期的收入、净利润和稀释 EPS。

财报电话会议记录

查阅管理层发言,核对发言人及会议日期。

历史日线价格

查询财报发布前后的开盘价、收盘价和成交量。

访问 FMP 官网 · QVeris 接入文档

相关指南

AI 智能体市场数据 API 指南

在 QVeris 中,将 FMP 数据用于 AI 智能体工作流 | QVeris Guides