如何使用我們的 API 進行報稅

最後更新: 2025年3月31日

Application Programming Interface(應用程式介面,簡稱 API)是不同服務(在此情況下為交易所和報稅服務)之間互動的方式。

有時服務可以透過 API 使用公開數據自由通訊,然而,當涉及到查詢報稅所需資訊(例如您的帳戶餘額、交易歷史等)時,情況會變得更複雜,因為這些資訊受到您的用戶名/密碼/2FA 保護(您絕不應與任何人分享)。

使用 API 將您的報稅平台連接到您的 Kraken 帳戶,是一種在不分享您的登入資訊的情況下,允許存取您帳戶數據的有效方式。

為了將您的報稅平台連接到您的 Kraken 帳戶,您需要透過 API 金鑰授予報稅平台存取您帳戶資訊的權限。

您不希望任何第三方知道您的用戶名/密碼/2FA,也不希望他們在您的帳戶上進行交易或提款,因此會改用具有適當權限的 API 金鑰。

您授予 API 金鑰的權限將設定其他平台可以在您的帳戶上查看和執行的範圍。

一般而言,報稅軟體計算您的資本利得/損失所需的權限如下:

查詢資金、查詢已結訂單和交易(部分交易所可選)、查詢分類帳條目以及匯出數據。

這些被稱為唯讀權限,意味著它們允許其他平台查看您帳戶中的資金以及您帳戶歷史中的交易,但不允許它們對您的帳戶進行任何更改(沒有新交易,也沒有新資金交易)。

讓我們看看這在 Kraken PRO 上是什麼樣子:

Kraken PRO

如需了解如何在 Kraken 上建立 API,請參閱下文。

資金:

查詢:這允許 API 金鑰查看帳戶餘額和資金記錄(歷史存款和提款)。

訂單和交易:

查詢已結訂單和交易:這允許 API 金鑰查看帳戶上的已結訂單和交易(這用於幫助確定損益)。

數據:

查詢分類帳條目:這允許 API 金鑰查看帳戶分類帳,其中記錄了所有過去的交易/資金交易。

匯出數據:這允許 API 金鑰匯出上述所有數據,包括您的交易和帳戶分類帳歷史記錄(通常為 CSV 格式)。

如需了解如何將您的 Kraken 帳戶連接到 Koinly,請瀏覽:

首先選擇您的居住國家/地區

1

接下來點擊「新增錢包」並選擇 Kraken

2

若要使用 API「自動同步」方法,請輸入您從 Kraken.com 取得的 Public 和 Private Key,然後點擊「新增 Kraken」。

3

3

4

若要手動上傳您的 CSV 檔案,請使用 CoinTracker CSV 指南重新格式化您的數據,並將其載入 CoinTracker CSV 範本。

完成後,請將已完成的 CoinTracker CSV 範本拖放到指定的上傳區域。

5

如果您需要進一步協助,請參閱下面的 CoinTracker 逐步指南。

從主頁設定您的基本設定

1

點擊下一步,然後點擊「查看更多選項」

2

從錢包/交易所列表中選擇 Kraken

4

5

請將您的 Kraken Public 和 Private keys 複製並貼到 API Key 和 Secret Key 欄位中,然後點擊「連接交易所」

4

從主頁,請選擇「輸入幣種」並搜尋並選擇 Kraken(不要與 Kraken Futures 混淆)

Select Exchange/Wallet

向下捲動到「建立新的自動 Kraken 工作」,然後貼上 API Key 以及您的 API Private Key (secret),然後點擊「儲存此 Kraken 工作」

Input Public/Private Keys

若要手動上傳您的 CSV 檔案,請點擊「CSV 匯入」分頁,然後將您的 CSV 檔案拖放到該處,並點擊「繼續匯入」。

Manually Upload CSV file

最後,請點擊「開始匯入」

Manually upload CSV file

Successfully uploaded CSV file

如果您需要進一步協助,請參閱下面的 CoinTracking 逐步指南:

如需將 Kraken 數據上傳到 Crypto Tax Calculator (CTC) 的綜合指南,請瀏覽我們的支援文章:

從儀表板頁面,點擊右上角的「+ 整合」按鈕:

Blockpit

接下來,當提示選擇錢包時,請選擇 Kraken。

它在「最受歡迎的整合」下清晰列出。

接下來請選擇 Kraken(用於 Spot API Data)或 Kraken Futures(用於 Futures Data)。

*請注意,Kraken Futures API Keys 與 Kraken SPOT API Keys 是獨立且不同的,不能互換使用*

Blockpit

Blockpit 3

請從您的 Kraken 帳戶複製您的 API Key 和 API Private Key,並將它們貼到 Blockpit 網站上的相應欄位中,然後點擊「繼續」。

Blockpit 3

點擊「繼續」後,您的帳戶餘額和交易歷史記錄的同步過程將開始。根據您的帳戶歷史記錄長度,這可能需要幾秒鐘或幾分鐘。

Blockpit 4

您的 Kraken(和 Kraken Futures)餘額將顯示在儀表板的「整合」下,您可以在任何時候同步數據,或者在擁有有效的 Blockpit 許可證的情況下,每 24 小時自動同步一次。

如果您需要進一步協助,請參閱下面的 Blockpit 逐步指南。

  • 當我將我的 Public 和 Private Key 新增至第三方軟體時,出現「Invalid key error」(無效金鑰錯誤)。

    如果出現此錯誤,請先確保您正確複製了 Public 和 Private Key。如果您已這樣做但仍收到「Invalid key error」(無效金鑰錯誤),請建立一個具有正確權限的新金鑰,然後再試一次。

  • 我的 Earn/Staked 餘額沒有顯示。

    部分第三方稅務軟體無法透過 API 正確匯入我們的 Staked 資產餘額。這通常可以透過匯出您的帳戶歷史記錄並手動上傳到第三方網站來解決。若要了解如何手動匯出您的帳戶歷史記錄,請點擊下方。

  • 我的部分交易遺失了。

    即時買入/賣出功能不會記錄在帳戶交易歷史記錄中,但可以在帳戶 Ledger 中查看。部分第三方平台無法正確解讀帳戶 Ledger 上的買入/賣出條目。如果發生這種情況,請手動匯出您的帳戶歷史記錄並將檔案上傳到您正在使用的第三方平台。

  • 我手動下載了我的帳戶歷史記錄,但我不明白這些符號的含義。

    您的完整帳戶歷史記錄由兩部分組成,即您的 Ledger 和您的 Trades。首先,讓我們了解一下兩者之間的區別。

    現在我們已經充分了解您的帳戶 Ledger 和 Trades history 之間的區別,接下來讓我們看看如何解讀每一個。

  • 將我的 API keys 提供給第三方軟體安全嗎?

    只要第三方網站/應用程式需要您的 Kraken private API keys,就可能存在潛在的安全問題,但只要您建立一個具有最低權限的特定 API key,例如僅用於讀取您的餘額和/或 Ledger,您的資金或整體安全性就沒有風險。因此,建議您授予唯讀權限,並建立一個具有這些權限的特定 API key,以便與您信任的第三方軟體共用。


需要更多幫助?