摘要:财务数据API里的Q4记录能当全年利润用吗?用寒武纪财报复算归母净利润TTM,核对API差额、利润口径和披露时点,附可直接运行的Python代码。
把财务数据API接进研究表时,年度查询里出现的一条记录,该直接填进“全年净利润”吗?核对寒武纪(688256.SH)时,我们碰到了这个问题:取到的2025年记录标着Q4,金额约4.55亿元。把它当作全年输入,算出来的TTM是25.64亿元,用年报全年金额复算则是41.69亿元。一个期间标签,让研究表少算了约16.05亿元。
排查可以按这个顺序做:先把三个输入对应到日历,再核对报表里的利润行,最后确认研究那天能否用到这份数据。下面用同一组财报和接口快照走一遍。
一、公式里的减法到底减掉什么
先把“最近12个月”放到日历上。以2026年9月30日为截止日,观察区间从2025年10月1日开始,正好是2025年第四季度,加上2026年前三季度。
| 已有报表里的期间 | 计算时怎么处理 |
|---|---|
| 2025年全年 | 减去2025年1—9月,留下10—12月 |
| 2026年1—9月 | 接在上年第四季度后 |
| 最终覆盖 | 2025年10月1日至2026年9月30日 |
今年前三季度已经有累计数,缺的是去年第四季度。用去年全年减去去年前三季度,便把它单独留下来:
2025年全年 − 2025年1—9月 = 2025年10—12月
2025年10—12月 + 2026年1—9月 = 最近12个月
因此,减去上年同期是在移走已经不属于观察窗口的旧月份,再加入本年累计,把窗口向前滚动。公式也就有了具体含义:
TTM=上年全年+本年累计-上年同期累计
寒武纪(688256.SH)的三个输入如下,统一采用合并利润表中的归母净利润,单位为人民币元:
| 输入 | 覆盖期间 | 归母净利润(元) |
|---|---|---|
| 上年全年 | 2025年1—12月 | 2,059,228,538.67 |
| 本年累计 | 2026年1—9月 | 3,714,522,759.80 |
| 上年同期累计 | 2025年1—9月 | 1,604,645,744.11 |
前一个数在《2025年年度报告》第103页;后两个数都在《2026年第三季度报告》第10页,分别取本期列和上年同期比较列。三个数,只需要两份报告。
上年第四季度:
2,059,228,538.67 − 1,604,645,744.11 = 454,582,794.56元
最近12个月:
454,582,794.56 + 3,714,522,759.80 = 4,169,105,554.36元
≈41.6911亿元
先保留原始元值计算,再换算亿元展示,才能继续核对小额差异。三季报中的“本报告期”还可能指7—9月,找累计值时要认准“年初至报告期末”或“1—9月”。把前三季度乘以4/3,是对第四季度作外推;这里的TTM拼接的是已经发生的四个季度。
二、为什么同一家公司会有两个净利润数
这次始终取“归属于母公司股东的净利润”,也就是归母净利润。合并利润表中的“净利润”还包括归属于少数股东的损益,两者不能只凭名称相近就混用。
| 寒武纪2026年1—9月利润表项目 | 人民币元 |
|---|---|
| 归属于母公司股东的净利润 | 3,714,522,759.80 |
| 少数股东损益 | −223,016.44 |
| 合并净利润 | 3,714,299,743.36 |
这里有个容易读错的细节:“归属于母公司股东”讲的是集团利润怎样分配归属;“母公司利润表”则是另一张报表,反映母公司这个会计主体。不能看到名称都有“母公司”,就把后一张表的净利润当成归母净利润。
本例把两种口径分别计算,结果为:
| 同口径计算方式 | TTM结果(元) |
|---|---|
| 三个输入都取归母净利润 | 4,169,105,554.36 |
| 三个输入都取合并净利润 | 4,168,749,076.59 |
两种口径各有明确含义,选定哪一个,就从全年、累计到同期比较一直沿用。币种、元或万元、合并范围也要一致。遇到报告修订,应核对比较数和全年数是否仍能衔接,不能只按年份拼起来。
三、数算出来了,为何还要看披露时间
截至9月30日的利润,不等于9月30日收盘时已经知道的利润。看清公司过去赚了多少,需要利润期间;回到历史某一天做研究,还要知道那一天能取得什么信息。
本例把几个容易混淆的日期分开记录:
| 日期字段 | 本例记录 | 它回答什么 |
|---|---|---|
| 报告期末 | 2026-09-30 | 这份累计利润算到哪一天 |
| 官方PDF路径日期 | 2026-10-24 | 所引用三季报文件的归档路径日期 |
| 本次接口调用日 | 2026-11-15 | 本文这次何时获取并保存接口快照 |
| 精确首次可得时刻 | 尚未核实 | 历史研究中,最早何时可以使用这一版本 |
归档路径日期不能直接补成当天00:00,也不能拿本次取数日倒推数据过去已经可用。本轮未核实交易所精确发布时间、具体接收渠道的到达时间和历史修订版本,因此保留“首次可得时刻待核”。这个日期差异不靠猜测填平。
如果你在今天更新研究表,可以先按当前已取得的报告做本例计算;如果要把41.69亿元放回过去某天的选股或回测输入,就应先补齐当时已经公开且可取得的版本,并与决策时点对齐。即使时间先后通过,也还要检查版本和口径。不要仅凭财报期末把完整三季报数据提前放进去。
下面的脚本把未知的可得时间保留为None,遇到它会返回“待核”,不会自动认定这个历史输入已经可用。它提供核对提醒,不构成完整的历史时点数据系统。
四、真实核对里,字段名字还不够
本次核对使用了2026年11月15日留存的TickDB MCP财务响应:年度记录、季度记录和TTM记录都已成功返回。接口字段名为NetProfit,显示为“净利润”,但字段名字本身不能代替报表口径核对。
| 核对项目 | 金额(元) |
|---|---|
| 报表三数法:归母TTM | 4,169,105,554.36 |
| 报表三数法:合并净利润TTM | 4,168,749,076.59 |
| 接口NetProfit TTM | 4,169,105,555 |
| 接口减归母口径 | 0.64 |
| 接口减合并口径 | 356,478.41 |
这次接口金额贴近归母口径。0.64元的差额先留在核对表里,原因还待确认。换一家样本时,同样要把字段和对应的利润表行核一遍。
另一个实际发现是:本次年度工具中的2025年一条记录,金额为454,582,797元,标记为Q4/q4,与报表倒算的第四季度接近,而非全年金额。若把它当成上年全年代入公式,会得到约25.64亿元,少算约16.05亿元。这个25.64亿元是误代输入的演示结果,不是接口直接返回的TTM。
原始TTM的period_end还是2026-09-29,与官方报告期末相差一天,原因同样待核。它不是已核实的披露日期,也没有被悄悄改成9月30日。接口四个单季相加与其TTM一致,说明本次内部加总一致;对照官方报表,则是另一条独立核对路径。
这次核对使用留存的TickDB MCP财务响应。结构化的单季记录和TTM字段可以放进同一张核对表,先做四季加总,再用公司报表交叉核对。接入时把原始期间标签和金额一起留存,碰到差异就能追到具体输入。
如果两个页面给出不同的TTM,先查什么
先把两个数各自覆盖的月份写出来,再把利润行的完整名称写出来。一个是全年、一个是最近12个月,或者一个含少数股东损益、另一个只归属于母公司股东,都可能产生差异。
等期间和归属对上,再核单位、报告版本和取数时间。不必先把两个数字平均,也不要挑较大的一个。你要找的是能回答同一个问题的金额;仍有残差,就把原值、差额和待核原因一起留下。
五、想自己复算,可以直接运行这段代码
把下面代码保存为ttm_reconcile.py,用Python 3运行python3 ttm_reconcile.py即可。只用标准库,不需要密钥、第三方包或外部文件。
代码使用两份报表的原值和2026年11月15日的接口快照,做离线复算,不会获取新财报或发出交易请求。历史检查里的2026年10月1日只是演示决策时点,首次可得时间仍为未知。
"""Python 3标准库;寒武纪688256.SH的TTM离线复算。
报表:2025年年报p103、2026年三季报p9—10,人民币元。
接口值为2026-11-15实际返回的快照;本脚本不联网、不交易。
"""
from decimal import Decimal as D
from datetime import datetime
def ttm(annual, current_ytd, prior_ytd):
return D(annual) + D(current_ytd) - D(prior_ytd)
parent = ttm("2059228538.67", "3714522759.80", "1604645744.11")
total = ttm("2058487389.36", "3714299743.36", "1604038056.13")
api_ttm = D("4169105555")
quarters = ["454582797", "1013213582", "1297698503", "1403610673"]
api_quarter_sum = sum((D(x) for x in quarters), D("0"))
# 三个日期分别记录,不用报告期末冒充首次披露时刻。
report_period_end = "2026-09-30"
archive_path_date = "2026-10-24" # 官方PDF路径日期,不是精确首发时间
api_snapshot_date = "2026-11-15"
raw_api_period_end = "2026-09-29" # 原值保留,差异原因待核
verified_available_at = None # 本例未核实,不能补成某日00:00
def availability_at(cutoff, available_at):
if available_at is None:
return "待核:首次可得时刻未核实,不纳入已验证历史输入"
c = datetime.fromisoformat(cutoff)
a = datetime.fromisoformat(available_at)
if c.utcoffset() is None or a.utcoffset() is None:
raise ValueError("时间必须包含时区")
if a > c:
return "不可用:晚于指定研究时点"
return "通过时间检查;仍须核对当时可得版本和数据口径"
print(f"归母TTM:{parent:,.2f}元")
print(f"合并净利润TTM:{total:,.2f}元")
print(f"接口TTM:{api_ttm:,.2f}元")
print(f"接口减归母口径:{api_ttm-parent:,.2f}元")
print(f"接口减合并口径:{api_ttm-total:,.2f}元")
print(f"接口四季加总:{api_quarter_sum:,.2f}元")
print(f"接口TTM减四季加总:{api_ttm-api_quarter_sum:,.2f}元")
print("报表期末:", report_period_end)
print("官方文件路径日期:", archive_path_date)
print("接口快照日期:", api_snapshot_date)
print("接口原始period_end:", raw_api_period_end)
# 以下是演示检查时点,不是交易信号或已证实的披露时间。
print("历史时点检查:", availability_at(
"2026-10-01T09:30:00+08:00", verified_available_at))
本次实际运行输出:
归母TTM:4,169,105,554.36元
合并净利润TTM:4,168,749,076.59元
接口TTM:4,169,105,555.00元
接口减归母口径:0.64元
接口减合并口径:356,478.41元
接口四季加总:4,169,105,555.00元
接口TTM减四季加总:0.00元
报表期末: 2026-09-30
官方文件路径日期: 2026-10-24
接口快照日期: 2026-11-15
接口原始period_end: 2026-09-29
历史时点检查: 待核:首次可得时刻未核实,不纳入已验证历史输入
换公司时,应同时更换三组报表数、接口快照、报告期间及时间记录。首次可得时间只有核实后才能填写;不要为了让检查通过,随意填一个日期。这段代码可在本地直接复算。
六、下次换家公司,照着这张表找数
| 核对项 | 本例应保留的记录 |
|---|---|
| 公司与数据对象 | 寒武纪688256.SH,合并利润表 |
| 主要利润口径 | 归母净利润,三个输入取同一行 |
| 金额单位 | 人民币元,保留原小数计算 |
| 三个覆盖期间 | 2025全年、2026年1—9月、2025年1—9月 |
| 报表来源 | 2025年年报p103;2026年三季报p9—10 |
| TTM期间与结果 | 2025-10-01至2026-09-30;4,169,105,554.36元 |
| 时间可得性 | 归档路径日、接口调用日分别记录;精确首次可得时刻待核 |
| 接口原值与差额 | NetProfit为4,169,105,555元;对归母差0.64元 |
| 原始日期标签 | period_end为2026-09-29,未据此改写报表期末 |
| 待核范围 | 字段通用定义、残差及日期差异、首次可得时刻与历史版本 |
记住TTM公式,可以开始计算;把三个输入的期间、口径和可得时间讲清楚,才方便继续使用这个结果。对本例来说,41.69亿元是一段已经实现的归母利润;是否值得投资,还需要另外的研究判断。
换成资产负债表余额、利润率或每股收益时,先回到各自的计算口径。这里的加减法用的是可按期间相加的净利润金额。
资料来源:中科寒武纪科技股份有限公司《2025年年度报告》合并利润表第103页(经审计)、《2026年第三季度报告》合并利润表第9—10页(未经审计);两份官方PDF的归档路径;2026年11月15日留存的TickDB MCP财务响应。本文未核实精确首次披露时刻,也未重新调用接口获取新的样本。