如何将 WEEX 交易历史导入 Cryptact（用于日本加密货币报税）

要点：WEEX 目前不是 Cryptact 自动集成的交易所（它不在 Cryptact 的支持交易所列表中，因此没有 API 自动同步或自动文件导入功能）。如要在 Cryptact 中使用你的 WEEX 加密货币交易历史计算盈亏，你需要填写 Cryptact 的通用“custom file”——一个包含 10 列的 CSV/Excel 模板——填入 WEEX 交易后再上传。本指南介绍：(1) 如何从 WEEX 获取交易历史；(2) Cryptact 自定义文件的确切格式；(3) WEEX 字段与 Cryptact 列的对应关系；(4) 完整示例（均为假设）；以及 (5) 这些收益如何计税。本文仅供参考，不构成税务建议。请向持证税务专业人士（税理士）或日本国税厅确认你的具体税务处理方式。

本文中的 Cryptact 和 WEEX 规格已根据两家公司公开文档直接核对（请参见本页末尾的日期及账本事实）。规格可能发生变化——操作前务必重新查看当前官方页面。WEEX 与 Cryptact 之间不存在合作关系。本文提及 Cryptact，仅是因为它是日本广泛使用的税务计算工具之一。

为什么采用“custom file”方式

对于受支持的交易所，Cryptact 可以通过 API 密钥同步或自动文件导入获取历史记录。但WEEX 不在 Cryptact 的支持交易所列表中（Cryptact 的 WEEX 页面返回错误或没有条目；核查日期为 2026-07-19）。对于不受支持的交易所，以及衍生品或保证金交易，Cryptact 官方记录的方法是使用通用的custom file，由用户自行填写。WEEX 完全属于“不受支持的交易所”情形，因此应采用自定义文件方式。

操作流程（3 步）

1. 从 WEEX 获取交易历史（通过 App/网页历史记录页面，或 API）。
2. 将其整理为 Cryptact 的 10 列 custom file（使用下方映射表）。
3. 将文件作为 custom file 上传到 Cryptact。

第 1 步：从 WEEX 获取交易历史

实际可选方式取决于交易量。截至本次调研，我们无法确认 WEEX 提供官方的一键“将交易历史导出为 CSV”功能（帮助中心未找到相关文章；本次调研也未验证登录后交易页面是否有导出按钮）。实际上，你可以采用以下方式：

• 方法 A——从 App/网页历史页面手动记录（适合交易量较小）。使用 WEEX 的订单历史、交易历史或资产（资金）历史页面，读取每笔成交的日期时间、交易对、方向、数量、价格和手续费，然后将其录入自定义文件。
• 方法 B——通过 WEEX OpenAPI 获取（适合交易量较大或自动化处理）。WEEX 于 2026 年 3 月推出了 OpenAPI（测试版）；你可以使用只读密钥读取历史记录，再将其整理为自定义文件。主要端点如下。

WEEX OpenAPI 历史端点（只读）

身份验证使用签名请求头（ACCESS-KEY / ACCESS-SIGN / ACCESS-PASSPHRASE / ACCESS-TIMESTAMP）。历史端点需要 USER_DATA（读取）权限，因此使用只读 API 密钥（不含交易权限）即可获取历史。

期货成交可获取最近 365 天的数据，每次请求最多覆盖 7 天；收入账本每次请求最多可覆盖 100 天。所有时间戳均以 UTC 毫秒返回（下文介绍 JST 转换）。

第 2 步：Cryptact 自定义文件格式（10 列）

根据 Cryptact 官方帮助文章“How to create a custom file”，Cryptact 的自定义文件包含10 列（A–J）（可下载日文/英文 Excel 和 CSV 示例）。除“Comment”外，所有列均为必填项。

Cryptact 的关键规则（请严格遵守）：

• 时间戳格式为 YYYY/MM/DD HH:mm:ss。
• 即使手续费为 0，也必须填写 Fee（Fee 单元格留空会导致上传错误）。
• Price 自动参考：只有当 Base 是 Cryptact 支持的币种且 Counter 是法定货币（例如 JPY）时，才能将 Price 留空并让 Cryptact 自动填入市场价格。如果基础币不受支持，或 Counter 是加密货币（例如 USDT），则必须自行填写Price。
• Comment 中不要输入字符 ' " \（否则上传会失败）。
• 直接打开或编辑 CSV 可能导致文件损坏（乱码）。请按照 Cryptact 的帮助说明编辑。对于小数位数达到 15 位以上的数值，请使用 Cryptact 专用示例文件。

第 3 步：WEEX 字段 → Cryptact 列映射

WEEX 是一家以期货（衍生品）为主的交易所。期货（保证金）和现货在 Cryptact 中的记录方式不同，请根据适用情况选择对应映射。标有 [ASSUMPTION] / [JUDGED] 的行并非源规格明确说明的内容，而是本指南的推断/建议；依赖这些内容前请先核实。

映射（1）：现货交易

来源：WEEX “Get Trade History” GET /api/v3/myTrades（或交易历史页面）。对于交易对 BTCUSDT，拆分为 Base = BTC，Counter = USDT。

映射（2）：期货 / 衍生品（保证金）

Cryptact 官方建议衍生品采用“只关注保证金抵押品变化”的方法。WEEX 期货采用 USDT 保证金，因此记录已实现盈亏（USDT）的净变化——收益记为 BONUS，损失记为 LOSS（会减少保证金的强平/强制平仓也记为 LOSS）。数据来源可以是 WEEX 的“Get Trade Details”中的 realizedPnl，或“Get Account Income”中的 income。

[判断 / 备注]上表是 Cryptact 推荐的“仅记录保证金变化”方法。如果记录的是扣除手续费和资金费后的净抵押品变化，Fee 可以填写“0”。如果希望分别列出手续费和资金费，则使用“Get Account Income”中的 incomeType 分类（position_close_long / position_funding / order_fill_fee_income 等）；但对大多数用户而言，简单的保证金变化方法已经足够。Cryptact 还记录了高级选项：向英文自定义文件中添加 DerivType = fx/future/option/cfd 和 DerivDetails 列，但该方法本身不能反映加密货币抵押品的变化，因此大多数情况下，上述简单方法更为合适。

完整示例（所有数字均为假设）

这些示例仅用于说明格式，并不代表真实交易或价格。

示例 1：现货买入 BTC（假设）

“2026 年 1 月 15 日（JST），以 95,000 USDT 的价格在 BTC/USDT 上买入 0.01 BTC，手续费为 0.0951 USDT（假设）。”

示例 2：现货卖出 BTC（假设）

“2026 年 2 月 3 日（JST），以 98,000 USDT 的价格在 BTC/USDT 上卖出 0.01 BTC，手续费为 0.098 USDT（假设）。”

示例 3：期货已实现盈亏——收益（假设）

“在一次 BTCUSDT 期货结算中，USDT 保证金因已实现盈亏增加了 +30 USDT（假设）。”

示例 4：期货已实现盈亏——损失（假设）

“在另一次结算中，USDT 保证金因已实现盈亏减少了 −18 USDT，其中包括强平损失（假设）。”

注意 UTC → JST 转换

WEEX API 返回的所有时间戳均为UTC。日本标准时间（JST）比 UTC早 9 小时。Cryptact 的自定义文件不会在 Timestamp 列中明确标注时区，但由于 Cryptact 以 JST 为基础进行计算，将 WEEX 的 UTC 时间转换为 JST（+9 小时）是更稳妥的选择，这样 WEEX 记录才能与其他日本数据对应起来（这是本指南的建议，因为规格并未明确说明这一点）。例如，UTC 时间 2026-02-09 18:00:00 的成交，在 JST 中是 2026/02/10 03:00:00。海外交易所的历史记录通常以 UTC 为基础，跨年时日期可能变化一天（12 月 31 日 / 1 月 1 日），因此务必特别注意年末交易。

这些记录如何计税（事实摘要）

对于日本居民，加密货币收益通常被归类为“杂项所得”（雑所得），并按照综合课税（総合課税）征税——与工资等其他收入合并，适用累进税率（加上居民税后，最高税负大约可达 55%）。在海外交易所交易并不会使其免于纳税。与日本国内交易所不同，海外平台不会出具年度交易报告，而且使用 UTC 时间戳，因此自行保存记录的必要性更高——这正是准确保存历史数据非常重要的原因。

• 记录很重要：保存每笔交易的日期时间、交易对、数量、价格、手续费和已实现盈亏，可以大幅简化报税季（通常为 2 月中旬至 3 月中旬）的工作。
• 使用计算工具：Cryptact（株式会社 pafin）是日本的加密货币盈亏计算工具之一，据公司介绍拥有超过 200,000 名用户。本指南仅以事实方式提及该工具；WEEX 与其之间不存在合作或背书关系。市场上也有其他工具，请自行选择。
• 最终判断应由专业人士作出：个人税务处理（所得分类、可扣除费用、亏损处理）因情况而异。务必向持证税务专业人士（税理士）或国税厅确认。本文不是税务建议。
• 开设 WEEX 账户

关于在 WEEX 上交易（期货优先）

WEEX 是一家以期货（衍生品）为主的加密货币交易所。期货和杠杆会同时放大收益与损失，剧烈波动还可能触发强平（强制平仓），从而实现亏损。交易前请理解相关机制和风险。历史获取及盈亏计算按照上述步骤进行。

常见问题

WEEX 是否受 Cryptact 自动支持？

截至本次核查（2026-07-19），WEEX 不在 Cryptact 的支持交易所列表中。因此，你不能使用 API 自动同步或自动文件导入，而需要通过自行填写的通用“custom file”导入。

WEEX 是否支持一键导出交易历史 CSV？

本次调研无法确认 WEEX 提供官方的一键 CSV 交易历史导出功能。实际操作中，你可以(1) 从 App/网页历史页面手动记录（交易量较小），或(2) 使用只读密钥通过 WEEX OpenAPI 获取数据。请查看当前登录后的页面，确认是否存在导出按钮。

如何记录期货（杠杆）盈亏？

按照 Cryptact 推荐的方法，只关注USDT 保证金的变化：收益记为 BONUS，损失记为 LOSS（包括强平），Base = USDT，Counter = JPY，Price 留空（见映射（2））。

是否需要将时间转换为 JST？

WEEX API 的时间为 UTC。由于 Cryptact 以 JST 为基础计算，转换为 JST（+9 小时）是更稳妥的选择。临近跨年时要特别小心，因为日期可能变化一天。

如果不知道手续费币种怎么办？

WEEX 的现货交易历史 API 可能不会返回手续费币种。请在 App 中确认手续费扣除的币种（收到的币种、WXT 等），然后将其填入 FeeCcy。即使没有手续费，Fee 也要填写“0”。

本文仅供参考，不构成税务或投资建议。请向持证税务专业人士（税理士）或日本国税厅确认税务处理方式。WEEX 与 Cryptact（株式会社 pafin）之间不存在合作关系；本文以事实方式引用 Cryptact 的名称和数据。规格基于两家公司官方文档（核查日期为 2026-07-19），且可能发生变化——操作前请重新确认。期货和杠杆交易存在损失被放大的风险。