OKX 导入 Koinly 后少记录,最常见的原因不是 Koinly 漏读,而是导入方式本身有覆盖上限。如果你用的是 API 同步,OKX 对 Koinly 的 API 只提供最近 3 个月的交易历史(最多 5,000 笔),更早的数据根本不在 API 返回范围内。换句话说,超过 3 个月的部分不是"没导进来",是 API 压根没给。补齐的唯一可靠路径是改用 CSV 手动导出并上传,而不是反复重连 API 或指望重新同步能把旧数据拉出来。
先判断你属于哪种"少记录"
在动手之前,打开 Koinly 的 Transactions 页面,筛选 OKX 钱包,对照 OKX 账户里的实际记录,确认缺失的是哪一类。这决定了补什么文件。
情况一:超过 3 个月的旧交易全部缺失。这是 API 导入的典型表现。Koinly 官方对 OKX 的集成说明写得很直接:交易历史仅提供最近 3 个月,最多 5,000 笔最近交易;其他交易类型仅提供最近 1 个月。对于更早的数据,官方建议使用 CSV 文件。如果你导入时用了 API,旧记录缺失是预期内的,不是故障。
情况二:某几笔特定交易没了,但时间上并不久远。可能是 CSV 文件选错了类型,或者文件本身不包含该类记录。OKX 的账单分为历史委托、交易账单、资金账单等不同类别,交易账单记录的是成交、手续费等交易相关变动,资金账单记录的是充提、C2C、金融等资金变动。如果你只导了交易账单,充值记录自然不在里面;反过来只导资金账单,成交记录也会缺失。
情况三:Convert 交易没有被识别。Koinly 社区有用户反馈,导入 OKX 的 Trading Account History 文件后,Symbol 以 -CONVERT 结尾的转换交易没有被自动识别。这是 CSV 解析层面的已知问题,不是你的操作失误。处理方式是在导入前编辑 CSV,把对应行的 Action 列手动填为 convert,或者导入后在 Koinly 里手动补录这几笔。
用 CSV 补齐的正确顺序
如果你确认是 API 导入导致旧数据缺失,不要继续在 API 上折腾。Koinly 帮助文档明确提醒:不要在同一钱包里混用 API 和 CSV,否则容易产生难以排查的重复记录。正确的做法是删掉 OKX 钱包,用 CSV 重建。
第一步:从 OKX 下载完整的交易账单。 网页端进入资产管理 → 订单中心 → 交易账单,选择自定义日期范围。OKX 的交易账单可下载从 2021 年 1 月 28 日至今的数据。如果缺少充值或提现记录,再单独去资金账单下载对应时间段的数据,资金账单覆盖自 2021 年 2 月起的记录。
第二步:不要用 Excel 打开文件再保存。 Koinly 官方多次强调,导入前不要用 Excel 打开 CSV,因为 Excel 可能改变日期格式、编码或数字精度,导致 Koinly 解析失败或产生错误。直接上传 OKX 导出的原始文件。
第三步:在 Koinly 中删除旧的 OKX 钱包,用 CSV 重新添加。 如果之前是 API 导入的,先删除该钱包,再通过 CSV 方式新建。如果已经同时存在 API 和 CSV 数据,删除后只用 CSV 重建可以避免重复。
第四步:导入后核对余额,而不是逐笔数记录。 Koinly 的判断标准是"计算出的期末余额是否与实际持仓一致"。如果余额对得上,说明关键交易基本齐全;如果余额对不上,再回到 OKX 账单里按时间范围排查缺的是哪一段。
如果 CSV 导入后仍然少
先检查时区。OKX 导出的账单时间戳可能不是 UTC,而 Koinly 以 UTC 为基准处理。如果时区偏移没有校正,跨日交易可能被归到错误日期,导致 Koinly 认为你在卖出某资产时"没有足够的买入记录",从而出现 Missing purchase history 警告。这不是记录真的丢了,而是时间错位让 Koinly 无法匹配买卖。
再检查是不是只导了部分文件。OKX 的 CSV 有不同报告类型,如果你只上传了交易账单而漏了资金账单,充值记录缺失会让 Koinly 看不到你最初买入资产的成本,后续卖出时就会显示成本缺失。按 OKX 的账单分类,把该时间段内涉及的所有变动类型都覆盖到。
我的判断
API 同步适合日常对账,不适合补历史。 如果你的 OKX 交易集中在最近三个月,API 导入够用;一旦涉及报税或跨年核算,直接走 CSV。Koinly 对 OKX API 的 3 个月限制是产品层面的设定,重连一百次也不会变。
补齐时优先保证"覆盖完整"而不是"文件数量少"。OKX 网页端可以一次性下载从 2021 年初至今的交易账单,一个 CSV 能解决的问题,不必拆成多次导出。代价是文件较大、Koinly 处理时间稍长,但比导入后发现缺一段再回头补要省事。
常见问题
Q:我重新同步了 API,为什么旧记录还是没出现?
A:因为 OKX 提供给 Koinly 的 API 数据范围本身就只有最近 3 个月(最多 5,000 笔交易)。重新同步只是再次请求同一范围内的数据,不会让 API 返回更早的记录。旧数据必须通过 OKX 网页端导出 CSV 来补充。
Q:删掉 Koinly 里的 OKX 钱包重新用 CSV 导入,之前手动改过的交易标签会丢吗?
A:会。删除钱包会移除该钱包下所有交易及你对这些交易做过的编辑(如标签、成本调整)。如果你的手动修改不多,重建后重新标记的成本可以接受;如果已经做了大量手动调整,更稳妥的做法是不删钱包,而是把缺失时间段单独导出 CSV,在 Koinly 中通过"添加交易"或导入到同一钱包的 CSV 入口补充,但要注意避免与已有 API 数据重复。
Q:OKX 的 Convert 记录在 Koinly 里显示为普通转账或不显示,怎么处理?
A:这是 OKX CSV 与 Koinly 解析之间的已知兼容问题。导出的文件中 Symbol 以 -CONVERT 结尾的行,其 Action 列可能为空或未被 Koinly 识别为交易。你可以在 CSV 里把这些行的 Action 手动改为 convert 后再导入,或者在 Koinly 中把这笔记录的类型手动编辑为交易/兑换,确保它被纳入成本计算而不是被当作无成本转账。
参考资料
- Koinly·How To Do Your OKX Taxes With Koinly,日期:2026-11-15
- Koinly·Some transactions are missing,日期:2026-11-15
- OKX·如何查看下载历史委托、历史仓位和交易账单?,日期:2026-11-15
- OKX·如何调取充提账单、账户结单,日期:2026-11-15
- Koinly·OKX CSV: Convert trades are not imported,日期:2026-11-15
- Koinly·Missing purchase history for XYZ,日期:2026-11-15



