OKX如何查看并导出历史委托单明细？
功能定位：为什么历史委托单明细值得单独导出
统一账户 3.0 把现货、合约、期权余额池合并后，历史委托单不再按币种隔离，而是连续编号。对散户，它是计算真实成本、核对带单收益、填报税务报表的唯一可信来源；对机构，它是审计函证、托管报告、做市返佣结算的底层凭证。2026 年 3 月版 App 将「税务看板」与「委托明细」拆成两条独立菜单，正是为了兼顾合规深度与日常速度。
前置检查：三条权限与两条隐藏限制
经验性观察：导出按钮呈灰色，99% 是以下权限未满足：
- 登录设备未绑定谷歌验证器或 Passkey，系统默认禁止「批量下载」；
- 子账户未开通「数据查询」角色，主账户需进入【子账户管理→角色模板】勾选「财务导出」；
- 近 30 天修改过登录密码，风控期 72 小时内限制「完整字段包」下载，仅开放「精简包」（无手续费、无撮合 ID）。
两条隐藏限制：①单次跨度≤90 天，②单日最多 10 次导出；超出后系统提示「频率保护」，次日 0:00（UTC）重置。
手机端最短路径（Android & iOS 一致）
步骤1：进入「资产」页签
底部导航栏点击【资产】→右上角「⋯」→【历史记录】→顶部切换【委托单】。默认展示最近 7 天，点日历图标可自定义区间。
步骤2：触发导出
页面底部出现「导出」按钮（若未出现，向上滑动一次强制刷新本地缓存）。选择格式：
- CSV-标准：含撮合 ID、手续费、返佣，适合财务对账；
- CSV-精简：仅时间、价格、数量，文件体积<1/3，适合快速浏览；
- XLSX-税务：预置「香港 0% 利得税模板」与「美国 FIFO」两张工作表，可直接套用。
点击「生成」后，系统弹窗提示「预计 30 秒内发送至安全邮箱」。此时可退出 App，无需常驻前台。
桌面端最短路径（Web）
步骤1：打开【订单】中心
顶部导航【交易】→【订单】→左侧栏【历史委托】。若使用「专业版」界面，需先点右上角「简」切换为「标准版」，否则「导出」按钮会被折叠到「更多」里。
步骤2：高级筛选
时间控件支持「自定义区间」与「快捷 90 天」；币种可输入底层+结算币对，如「BTC-USDT-SWAP」。需导出带单订单时，勾选「只看复制交易」即可单独生成子文件，方便拆分绩效。
步骤3：下载与完整性校验
Web 端提供「同步下载」与「邮件发送」双通道：文件<5 MB 直接弹出浏览器下载；>5 MB 强制走邮件，防止浏览器超时。下载完成后，可用内置「哈希校验」功能（按钮位于下载成功 Toast 右侧）比对 SHA-256，确保中转网络未篡改。
字段含义与对账技巧
| 字段名 | 常见误解 | 对账要点 |
|---|---|---|
| fee（手续费） | 已含返佣抵扣 | 需与「rebate」字段相加，才等于毛手续费 |
| execQty（成交数量） | 等于委托数量 | 部分成交时，execQty≤qty；全撤单后 execQty 可能为 0 |
| clOrdId（客户自定义 ID） | 仅 API 用户可见 | 网页/手机下单自动生成 UUID，可用于关联策略日志 |
工作假设：若「总手续费」与「账户快照」差额>0.01%，优先检查是否遗漏「强平订单」——强平记录默认归类到【系统】子目录，需单独勾选「显示系统事件」才会出现在同一文件。
例外与取舍：何时不该用内置导出
场景A：需要每日自动对账。内置功能无 API 触发器，手动导出易漏；推荐改用「GET /api/v5/trade/fills」 REST 接口，配合「endId 分页」+「时间窗口漂移 5 秒」策略，可无人值守。
场景B：子账户数量>50。Web 端一次只能选单账户，切换成本极高；应使用「母账户批量导出」工具（路径：【API 管理→批量数据】），文件打包成 ZIP，含所有子账户 CSV，节省 90% 人工。
场景C：税务年度跨越 2025-09-01 前。历史字段缺少「质押收益」与「资金费」细分，若直接提交给会计师，可能被要求补表；建议额外导出【资金流水】与【收益明细】两份报表，三表交叉验证。
故障排查：五种常见报错与复现方法
- 报错「参数错误 0004」：时间区间超过 90 天。复现：选 2025-01-01 至 2025-12-31，必现。处置：拆分为 4 段下载后用 Excel PowerQuery 追加。
- 报错「文件生成超时」：单日内委托>80 万笔。复现：高频网格账户选「全币种+365 天」。处置：改用「API+按币种循环」或联系客服申请「离线切片」，通常 4 小时内邮件返回。
- 报错「邮箱未验证」：注册后未点验证链接。复现：新注册子账户立即导出。处置：登录邮箱点击验证→稍等 30 秒→重新导出。
- 下载 CSV 中文乱码：macOS Numbers 默认用 UTF-16。复现：用 Safari 下载后直接用 Numbers 打开。处置：先用文本编辑器转 UTF-8 再导入。
- 字段缺失「rebate」：选择了「精简包」。复现：导出时勾选「精简」。处置：重新选择「标准包」即可，无需等待次日。
与第三方工具协同：最小权限原则
若把 CSV 自动上传到 Google Sheets，建议创建「只读 API Key」，IP 白名单限定在 Google 服务器段，并在 OKX 侧关闭「交易」权限。经验性观察：2026 年起 OKX 对「含 withdraw 权限」的 Key 实行「导出即风控」策略，触发概率>30%，而「只读 Key」几乎为零。
适用/不适用场景清单
| 维度 | 适用 | 不适用 |
|---|---|---|
| 账户规模 | 单账户月委托<50 万笔 | 母账户+200 子账户，月委托>1000 万笔 |
| 更新频率 | 月度、季度对账 | T+0 实时风控 |
| 合规要求 | 香港、美国 FIFO、新加坡 | 需自定义字段（如内部成本中心） |
最佳实践检查表
☑ 导出前确认「谷歌验证器」已绑定且已过 72 小时风控期
☑ 时间区间≤90 天，文件>5 MB 优先选「邮件通道」
☑ 勾选「标准包」并核对「rebate」字段，避免手续费误差
☑ 下载后立即做 SHA-256 校验，防止中间网络篡改
☑ 年度报税需额外导出【资金流水】【收益明细】三表交叉
FAQ（Must use FAQPage Schema）
为什么导出按钮是灰色？
请检查是否绑定谷歌验证器、子账户是否授予「财务导出」角色、近 3 天是否修改过登录密码。任一条件不满足即置灰。
能否一次导出全年数据？
系统限制单次≤90 天，全年需分 4 段。超过 80 万笔/年建议改用 API 循环拉取。
精简包与标准包差别多大？
精简包缺少撮合 ID、手续费、返佣三列，文件体积约 1/3，仅适合快速浏览，不适合财务对账。
收尾：下一步行动建议
刚结束季度交易，立刻打开 OKX App，按「手机端最短路径」导出最近 90 天标准包 CSV，用 Excel 透视表统计「fee+rebate」总和，再与资产快照对账，差额应<0.01%。若计划接入自动对账，先申请「只读 API Key」并测试单日拉取，确认无「频率保护」报错后再上生产。历史委托单是最容易被忽视却最致命的合规缺口，趁风控期未触发，提前备份才能安心迎接下一次牛市。
