财务数据API的TTM怎么核对?少算16亿元,错在把单季当全年

简介: 财务数据API里的Q4记录能当全年利润用吗?用寒武纪财报复算归母净利润TTM,核对API差额、利润口径和披露时点,附可直接运行的Python代码。

摘要:财务数据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财务响应。本文未核实精确首次披露时刻,也未重新调用接口获取新的样本。

相关文章
|
4天前
|
弹性计算 人工智能 API
Codex超详细入门指南(下载·安装·登录·上手,全版本覆盖,2026最新版)
建议收藏本教程,2026 全年各版本更新随时回来查阅。如果你在搭建过程中遇到任何问题,欢迎结合 阿里云工单系统 提交技术支持请求,或在 阿里云开发者社区 搜索 Codex 相关话题交流。 祝你编码愉快,效率翻倍!
1809 4
|
6天前
|
JSON 前端开发 API
阿里云最新Qwen4-Max大模型介绍:模型定位、特征、能力、适用场景解析
2026 年 11 月 11 日,阿里发布第四代旗舰模型Qwen4-Max预览版,首发千问 AI 平台 Token Plan,并同步接入千问办公、Qoder 等入口。该版本聚焦知识理解、世界感知、编程与 Agentic 四项升级,主打复杂编程、专业办公、前端设计与专业软件操作。预览期至 11 月 25 日 24:00,到期后模型标识下线;限时 2 折、新用户再享 5 折,最低 1 折可体验。
|
6天前
|
人工智能 前端开发 API
阿里云Qwen4-Max 大模型详解:定位、特征、能力、适用场景与相对Qwen3-Max差异解析
2026年11月11日,阿里发布第四代旗舰模型Qwen4-Max预览版,首发千问AI平台Token Plan并接入千问办公、Qoder等入口。该版本聚焦知识理解、世界感知、编程与Agentic四项升级,主打复杂编程、专业办公、前端设计与专业软件操作等真实任务。预览期为11月11日10:00至11月25日24:00,仅支持Token Plan调用,到期后模型标识下线;限时2折、新用户再享5折,最低1折可体验。
|
4天前
|
Linux Go 开发工具
手机上跑 DeepSeek 智能体:开源安卓客户端 DSH Go 安装与使用指南
DSH Go 是一款开源安卓客户端,将 DeepSeek Harness 智能体引擎装进手机:免 Root、免 Termux,一键安装即用;支持本机运行(内置 Ubuntu+Node.js)或远程接管电脑会话;具备插话打断、过程折叠、屏幕操控、端到端加密分享等特色功能,真正实现智能体“口袋化”。
3922 2
|
19天前
|
Linux 开发工具 iOS开发
Codex保姆级教程(下载+安装+登录+使用,含所有版本,2026最新)
Codex是OpenAI推出的开源AI编程智能体,本地运行,可理解整个代码库,支持自然语言指令改代码、执行命令、跑测试、修Bug,兼容Win/macOS/Linux。(239字)
8932 58
|
14天前
|
Linux 开发工具 iOS开发
2026最新codex下载安装保姆级使用教程(下载+安装+登录+使用,含所有历史版本)
本文详解OpenAI Codex国内快速上手指南:提供Win/macOS/Linux全平台免安装包、npm/Homebrew等多方式安装、账号/API Key双登录、简体中文切换,覆盖下载、安装、汉化、使用及高频避坑(如微软商店失败、npm超时等),10分钟即可跑通。
3138 9
|
20天前
|
JavaScript API iOS开发
DeepSeek Harness下载、安装、配置一篇搞定(2026整理,送常用插件)
DeepSeek Harness(DSH)是DeepSeek于2026年开源的MIT协议AI Agent框架,支持插件化组装模型、工具、沙箱与UI,兼容主流大模型。本文提供免Node.js的桌面端安装包(Win/macOS),含详细图文教程及热门插件推荐。
5878 69
|
7天前
|
云安全 人工智能 安全
|
12天前
|
人工智能 安全 API
DeepSeek Harness下载、安装、配置一篇搞定(2026整理,送常用插件)
DeepSeek Harness(dsh)是DeepSeek AI于2026年开源的轻量级Agent运行框架,基于Cordis内核,践行“一切皆插件”理念。支持Web/桌面双端,开箱即用;内置多模型接入、丰富插件生态(超3.5万),适配编程、办公、创作等场景。(239字)
1962 2