财务数据API里的TTM怎么算?三个数算清净利润,再核对披露时间

TickDB Research ·

摘要:用财务数据API更新股票研究表,TTM算对还不够,还要看利润覆盖哪段时间、是否都取归母口径、在研究时点是否已经披露。本文用寒武纪两份真实财报算出约41.69亿元,核对接口差额,附可运行Python代码、核对表和两张图。

三季报出来后,研究表里可能同时放着去年全年利润、今年前三季度利润和接口返回的TTM。把其中一个数填进“最近12个月”并不难,难的是填完以后还能解释:它从哪几个月拼成、归属于谁、在历史哪一天已经可得。

以寒武纪为例,2025年全年归母净利润约20.59亿元,2026年前三季度约37.15亿元。本文把它们接成最近12个月的41.69亿元,再与接口核对。计算、报表归属和时间可得性按同一条主线展开。

一、把最近12个月放到日历上

先把“最近12个月”放到日历上。以2026年9月30日为截止日,观察区间从2025年10月1日开始,正好是2025年第四季度,加上2026年前三季度。

TTM期间示意:从2025年全年移走1至9月,留下第四季度,再接上2026年前三季度

图1:橙色为上年第四季度,青色为本年前三季度;每格代表1个月。

今年前三季度已经有累计数,缺的是去年第四季度。用去年全年减去去年前三季度,便把它单独留下来:

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年前三季度合并净利润等于归母净利润加少数股东损益,少数股东损益为负数

图2:本例少数股东承担亏损,因此归母净利润高于合并净利润;计算TTM时三个输入仍须取同一行。

这里有个容易读错的细节:“归属于母公司股东”讲的是集团利润怎样分配归属;“母公司利润表”则是另一张报表,反映母公司这个会计主体。不能看到名称都有“母公司”,就把后一张表的净利润当成归母净利润。

本例把两种口径分别计算,结果为:

同口径计算方式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,显示为“净利润”,但字段名字本身不能代替报表口径核对。

核对项目金额(元)
报表三数法:归母TTM4,169,105,554.36
报表三数法:合并净利润TTM4,168,749,076.59
接口NetProfit TTM4,169,105,555
接口减归母口径0.64
接口减合并口径356,478.41

这次接口金额贴近归母口径。0.64元残差的原因尚未确认,不能直接归为四舍五入,也不能由这一家公司推出所有公司的NetProfit都有同一定义。

另一个实际发现是:本次年度工具中的2025年一条记录,金额为454,582,797元,标记为Q4/q4,与报表倒算的第四季度接近,而非全年金额。若把它当成上年全年代入公式,会得到约25.64亿元,少算约16.05亿元。这个25.64亿元是误代输入的演示结果,不是接口直接返回的TTM。

原始TTM的period_end还是2026-09-29,与官方报告期末相差一天,原因同样待核。它不是已核实的披露日期,也没有被悄悄改成9月30日。接口四个单季相加与其TTM一致,说明本次内部加总一致;对照官方报表,则是另一条独立核对路径。

本例通过TickDB的A股数据接口所提供的MCP财务记录保留字段、金额和期间,帮助研究者把取数与核对接起来;时间资格与历史版本仍需按研究任务核实。

五、运行代码,得到计算值与待核提醒

把下面代码保存为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
历史时点检查: 待核:首次可得时刻未核实,不纳入已验证历史输入

换公司时,应同时更换三组报表数、接口快照、报告期间及时间记录。首次可得时间只有核实后才能填写;不要为了让检查通过,随意填一个日期。代码是本地Python示例,未验证为聚宽平台内可直接运行的策略。

六、把核对表留给下一次更新

核对项本例应保留的记录
公司与数据对象寒武纪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描述的是过去12个月已实现的利润,不是未来盈利预测;资产负债表余额、利润率和每股收益也不能机械套用同一加减法。

资料来源:中科寒武纪科技股份有限公司《2025年年度报告》合并利润表第103页(经审计)、《2026年第三季度报告》合并利润表第9—10页(未经审计);两份官方PDF的归档路径;2026年11月15日留存的TickDB MCP财务响应。本文未核实精确首次披露时刻,也未重新调用接口获取新的样本。

相关文章

市盈率TTM怎么算?财务数据API指南:扣非利润与同行估值实算

市盈率TTM怎么算,扣非利润如何影响同行估值?本文以寒武纪和海光信息为真实案例,结合行情接口与正式财报,说明财务数据API研究中如何统一价格日期、股数基准和利润期间。两家的参考倍数差距在扣非后由10.33%缩至6.34%,并附营收与股东利润拆解、利润敏感性表及可直接运行的Python复算代码。

TickDB Research ·

黄金行情API怎么选?做黄金ETF工具,光有国际金价够吗?

为黄金ETF页面或持仓工具选择黄金行情API,国际金价只是其中一项输入。本文以518880和XAUUSD的真实返回为例,结合上金所及基金公司资料,拆清ETF成交价、国际金价与基金净值的分工,给出产品数据需求表和可复算的持仓参考金额。

TickDB Research ·

港股行情API怎么选?本地脚本搬上服务器,还要比较什么?

个人港股脚本搬到团队服务器,选行情API要比较的不只是价格。本文对照富途OpenD官方运行条件和一次腾讯控股真实快照,把网关、登录、行情权限、数据时间与团队使用需求拆开,给出可直接交给开发和数据供应商的试用清单。

TickDB Research ·

AI盯盘怎么用?自选股涨超3%,收到提醒后先看什么?

自己维护股票监控的量化投资者与投研成员,常常遇到同一只股票反复触发提醒,却不知道这次该看什么。本文通过TickDB股票行情API,取得2026年11月12日寒武纪、海光信息的真实分钟行情,重放两种提醒方式,并结合公司资讯梳理后续核查顺序:先看这次新增了什么变化,再看价格处在什么位置,接着查有没有值得更新原判断的信息。附可复制监控任务卡与重放代码,方便换成自己的自选股。

TickDB Research ·