EODHD 帮助文档与公开案例核查
日期：2026-11-10；范围：解释已有异常，不新增账户API请求、不改库、不联系供应商。

结论
确有其他使用者报告复权差异及分红/拆分遗漏，也有反馈得到修复。不能据此估计整体错误率，更不能推定510300的根因已经确认。当前官方文档能够解释部分口径差异，但不能解释本次中国ETF的全部现象。

1. 官方规则与本项目的对应
官方帮助说明原始OHLC不做分红/拆分调整，adjusted_close两者均调整，volume仅按拆分调整；美股成交量也会因汇总规则不同略有差异。历史记录可被修正，新增事件会重算整个历史；只提供当前版本、不保存修订时间。
来源：https://eodhd.com/help/methodology
官方教程另明确使用 (除息前收盘价 - unadjustedValue) / 除息前收盘价，并将因子应用于除息日前全部价格，最终保留四位小数。
来源：https://eodhd.com/financial-academy/financial-faq/adjusted-close-and-close-whats-the-difference
解释：不同下载日的复权绝对值变化可以正常；应比较统一基准后的因子与收益。不能把只有相邻三天调整、此前历史未调整直接解释为正常前复权。这是依据文档与样本作出的判断，非官方故障确认。

2. 他人确实遇过什么
A. Portfolio Optimizer 作者使用2021-05-05至2022-05-04的SPY、发行方分红与自己的复算接口，得到410.3167201489105，EODHD给出410.347；作者怀疑计算方法或舍入。这是当时的独立测试，未提供EODHD确认的根因或当前修复证明；其方法与今天EODHD教程的具体公式还需区分，不宜沿用作者结论判定今天数据错误。
来源：https://portfoliooptimizer.io/blog/selecting-a-stock-market-data-web-api-not-so-simple/
B. Bogleheads《Testfol.io data errors》，2024-10-18：订阅用户Hydromod自述发现约六个标的有问题，多为2000年前共同基金，常见漏分红/拆分，并反馈EODHD修复很快。10月19日原帖作者表示SCHP问题已经修好。属用户反馈，未见供应商工单；一两小时不是官方SLA。网页直接打开403，本轮依据搜索工具返回的完整帖子文本，未声称保存论坛原始HTML。
来源：https://www.bogleheads.org/forum/viewtopic.php?p=8083319
C. Reddit SAFE案例（对比数据截至2024-03-15）展示多个供应商raw/adjusted差异；评论提出并购、更名、拆分与分红调整范围等可能原因。未见EODHD确认的最终解释。讨论中另一个PRF漏分红案例指Yahoo，不能误算到EODHD头上。
来源：https://www.reddit.com/r/algotrading/comments/1bh1rw0/why_it_is_so_hard_to_get_consistent_stock/

3. 本项目如何理解
- QQQ/SPY：已有收盘价样本一致，亚美分差异应按精度容差处理，成交量另核。QQQ六月约0.00298美元的归一残差尚未闭合；本轮复核原事件value与unadjustedValue同为0.81349，旧复算也确实使用unadjustedValue，不能归因于混用这两个字段。今天看到的官方具体公式与旧复算一致，更新了旧报告中“此公式未获供应商明确说明”的限制；仍不能凭此确定内部根因。
- 510300：2026-01-19每份0.123分红有发行方公告，但认证div响应为空；价格因子只影响相邻三天，与官方全历史回溯说明不符。需要供应商核对事件覆盖与历史重算。
- 510300：2025-12-22 OHLC全为4.688，和前收相同；本轮读取已有原响应发现volume为837121964，并非零成交量空条。多源当日行情不同，不能简单解释为休市占位，也不能归因于复权字段读错。平填原因尚未知。
- 本轮未找到510300/511010这些具体日期的公开工单或官方修复公告；没有找到不代表不存在。本次未重新请求511010。

4. 建议及待供应商回答的问题（未发送）
先保留美股候选，联合覆盖国内ETF的购买决定待关键异常解释或修正后再定。
问题一：510300.SHG的2026-01-19分红是否支持？为什么div为空而价格仅在1月14日至16日体现该因子？请复算完整受影响历史。
问题二：2025-12-22为什么非零成交量下四价都是4.688？是否使用了前收占位或错误上游数据？请提供该日应有OHLC。
问题三：QQQ.US 2026-06-22使用0.81349现金分红，依官方公式复算仍有小残差；实际使用的事件金额、前收、内部精度和公式分别是什么？
机制建议：保留带下载日期的原响应；分开核对原价、事件、复权与成交量；事件前后验算整个受影响区间；修复后重取同一窗口并比较。异常不能只隔离，须留可复现请求、发行方证据和修复验收记录。本轮只提出建议，未修改采集逻辑。

证据入口：../实际三标的复查/三标的逐字段核验.json、原件/eod-510300.SHG.json、原件/div-QQQ.US.json、compare_three.py。
边界：本轮账户API调用0，未查询或改变账户额度；没有付费、改库、补采、启动服务或发送外部消息。
