美股历史行情API:回测收益偏高,分红是不是算了两遍?

TickDB Research ·

摘要:使用美股历史行情API做策略回测,换成复权价格、再补上分红,收益就一定更真实吗?本文面向量化研究人员和负责回测数据的技术成员,用苹果一次真实现金分红做收益对账:同样持有1,000股,分红只多算一次,账面损益就高出260美元。通过原始价格、复权价格与分红记录的对照,讲清股价变化、分红应收和现金到账如何影响收益,并给出可复算的方法,帮助团队先查清差额,再决定是否调整策略。

如果你正在给美股回测接入分红数据,或者准备把历史行情换成复权价格,有一笔账值得先算清楚:同一笔分红,最终会在哪里体现?

价格做了分红调整,收益计算里又加上一笔分红,看起来两边都照顾到了,却可能把收益算高。准备拿这条曲线比较策略、调整参数之前,得先确认增加的收益从哪里来。

我们用苹果的一次真实分红做了对照。苹果在2025年8月11日除息,每股现金分红0.26美元。假设按前一交易日收盘价持有1,000股,到除息日收盘,计入一次分红应收,亏损为1,910美元;如果把同一笔分红重复计入,结果就变成亏损1,650美元。这里不计税费,也不做分红再投资。

看起来少亏了260美元,持仓却没有因此多赚一分钱。差额来自我们的计算方式。

这次对账使用TickDB美股行情API取得的历史日线、分红记录和除权因子。同一个标的的几组数据放在一起,既能核对股价变化,也能追查分红究竟在哪一步进入了收益。

先从这1,000股的市值和分红应收算起,再回头看复权曲线,收益为什么对不上就容易理解了。

先把这260美元放回持仓

2025年8月8日,AAPL.US不复权收盘价为229.35美元。按这个价格持有1,000股,初始投入是229,350美元。

8月11日收盘价为227.18美元,股票市值变成227,180美元。只看股价,亏损是2,170美元。但这笔跨除息日持仓还有260美元税前分红应收,应当一起计入总资产。

对账项目金额
初始投入229,350美元
除息日收盘股票市值227,180美元
分红应收260美元
股票市值加分红应收227,440美元
持有期损益−1,910美元

于是,这段固定股数持仓的税前收益为:

(227180 + 260 − 229350)÷ 229350 ≈ −0.8328%

把同一组价格和持仓代入不同的分红计法,差别就出现了:

分红如何处理损益收益率
漏计分红−2,170美元−0.9462%
计入一次分红−1,910美元−0.8328%
重复计入分红−1,650美元−0.7194%

最后一行是我们主动设置的错误对照。它比正确账本高出260美元,收益率高约0.1134个百分点。

这笔差额容易核对:股票数量没有增加,分红也只有一笔。曲线好看了一点,却找不到对应的新增资产,就该先检查收益计算,而不是据此调整策略。

当日股价下跌也不能全部归因于除息。我们核算的是实际价格变化与分红权益的合计,不是在判断股价为什么下跌。

价格已经复权 分红还要不要加

复权会按分红等公司行动调整历史价格,让除息前后的曲线便于连续比较。但你当初按229.35美元买入一股,实际投入不会随着历史价格重算而改变。

image.png

图1|沿着两条数据路径,检查分红是否被重复反映。

本次查询得到的两日前复权收盘价,分别为228.06634138和226.16631634。两日相除,收益约为−0.8331%;用原始价格加一次分红,对应的持仓收益约为−0.8328%。

两者接近,却没有完全重合。前者采用调整后的价格基准,本例返回的因子数值也与按精确现金分红推算的系数略有差异。把它们一概视为同一个收益数字,后面就容易越对越乱。

更明显的错误是,在这段前复权收益上再加一次0.26 ÷ 229.35,结果会变成约−0.7197%。价格调整中已经反映的这次分红,又被叠加进了收益。

因此,不能只看到“前复权”三个字,就决定再加或不加分红。要沿着计算过程看:复权价格是用来生成交易信号,还是直接计算收益?现金分红是否已经进入了账户总资产?

如果只是用复权价格算指标,再用原始价格核算持仓,分红仍要在账本中记一次。若已经用反映这次分红调整的价格比计算收益,又叠加一笔分红收益,同一笔分红就会被算两遍。

判断策略之前先把收益对回持仓。把股数、原始价格、现金和分红应收列清楚,才能看出收益变化究竟来自策略,还是来自数据处理。

应收分红还不能当作可用资金

8月11日,这笔持仓已经拥有分红权益,但不代表260美元已进入可用现金。公司安排的支付日是8月14日,实际到账应查券商记录。

image.png

图2|同一笔分红从应收转为现金,支付安排与实际到账分开核对。

收到款项时,应收分红转为现金。这次转账本身不会再增加一笔收益。

这个时间区别会影响回测中的下一笔交易。如果程序在除息日就把260美元作为可用现金,随后用它买入股票,持仓路径也会改变。此时要查的除了“有没有算两遍”,还有“是不是提前使用了资金”。

不同回测引擎有各自的处理约定,接入数据前要先核对。QuantConnect的官方文档就按价格规范化模式区分处理:使用Adjusted或TotalReturn模式时,分红反映在价格中;使用Raw或SplitAdjusted模式回测时,LEAN会在除息日将分红加入现金账本。这是引擎的建模约定,不能直接当作券商真实到账时间。

如果现有引擎已经处理了分红,新增分红接口后,应先确认它用于核对、展示还是入账,避免再写一套现金派发逻辑。

复制这段代码 先对一次自己的收益

下面使用本次已归档的历史数值。Python 3即可运行,不需要第三方依赖、API密钥或下载附件。它复算的是这一笔固定股数持仓,便于你把结果与现有程序逐项对照。

from decimal import Decimal as D, getcontext

getcontext().prec = 40

# AAPL.US:2025-08-08与2025-08-11的历史收盘价
p0, p1 = D("229.35"), D("227.18")
adj0, adj1 = D("228.06634138"), D("226.16631634")
shares, dividend_per_share = D("1000"), D("0.26")

initial = shares * p0
stock_value = shares * p1
dividend = shares * dividend_per_share

correct_wealth = stock_value + dividend
duplicate_wealth = stock_value + dividend * 2

cases = [
    ("漏计分红", stock_value / initial - 1),
    ("计入一次分红", correct_wealth / initial - 1),
    ("重复计入分红", duplicate_wealth / initial - 1),
    ("前复权价格比", adj1 / adj0 - 1),
    ("前复权再加分红收益", adj1 / adj0 - 1 + dividend_per_share / p0),
]

for name, rate in cases:
    print(f"{name}: {rate * 100:.4f}%")

print(f"正确持仓损益: {correct_wealth - initial:.2f} USD")
print(f"重复计入虚增: {duplicate_wealth - correct_wealth:.2f} USD")

assert duplicate_wealth - correct_wealth == dividend
assert correct_wealth - initial == D("-1910")

运行结果:

漏计分红: -0.9462%
计入一次分红: -0.8328%
重复计入分红: -0.7194%
前复权价格比: -0.8331%
前复权再加分红收益: -0.7197%
正确持仓损益: -1910.00 USD
重复计入虚增: 260.00 USD

迁移到自己的数据时,先选一个只有普通现金分红、没有同时拆股等复杂行动的短窗口,核对币种、持股资格和股数,再替换价格与金额。不要直接用“除息日当天买入”的股票套算分红;普通现金分红通常需要在除息日前买入才有本次分红资格。

如果窗口里有分红再投资、买卖或外部资金进出,就需要逐笔更新股数和资金账,不能继续套用这里的固定股数公式。

接入美股历史行情API时 把这几项问清楚

选数据源或接手旧回测,不妨拿下面这张表和研究、工程同事一起核对:

要核对的问题应当查到哪里
收盘价是原始价,还是经过分红或拆股调整的价格具体字段定义与复权参数
同一笔分红在哪里入账,是否已经包含在收益里引擎的持仓、现金及收益计算逻辑
除息日、记录日和支付日是否混用事件字段、公司公告及到账记录
原始价与复权价是否来自同一标的、日期和采集版本标的代码、交易时区、查询时间与原始响应

接口名称本身也不够。例如Alpha Vantage的TIME_SERIES_DAILY_ADJUSTED,官方说明同时返回原始OHLCV、调整后收盘价和分红拆股事件。不能因为名字里有“ADJUSTED”,就把其中所有价格字段当成同一种复权价格。

本次通过TickDB统一取得AAPL.US的不同复权模式日线、分红事件与除权因子,价值就在于能沿用同一标的代码,把曲线变化与事件记录放在一起复核。对维护回测数据管线的团队,这能减少跨来源代码映射和字段拼接,保留追查差额所需的输入。相关接口能力可在TickDB美股行情API查看。

准备根据新曲线改策略之前,先找一个分红事件,把它对回真实持仓。260美元应该出现在哪里,什么时候能用,程序里出现了几次,这些问题清楚了,收益改善才值得继续研究。

数据与参考资料

历史日线、分红和因子采集于2026年11月12日,标的为AAPL.US。复权数值按本次采集版本保存,今后查询可能随公司行动或数据更新变化。价格为本次接口返回,事件金额与支付安排另核对公司资料。

核对时发现,接口公告日期为2025年8月1日,公司公告为7月31日;本文以公司日期为准,原始响应保留。

  • Apple:Dividend History;2025年7月31日第三财季业绩公告中的分红安排。
  • 美国SEC投资者教育网站Investor.gov:Ex-Dividend Dates,普通现金分红资格说明。
  • QuantConnect:US Equity Corporate Actions,Dividends部分。
  • Alpha Vantage:API Documentation,TIME_SERIES_DAILY_ADJUSTED部分。
  • TickDB:美股行情页面、MCP工具说明及本次历史查询原始响应。

相关文章

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

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

TickDB Research ·

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

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

TickDB Research ·

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

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

TickDB Research ·