如何將 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），且可能發生變化——操作前請重新確認。期貨和槓桿交易存在損失被放大的風險。