進階 API 常見問題

上次更新時間： 2025年11月25日

存款/提款交易的可能狀態值

使用 REST API 資金端點，客戶能夠將資金存入/提取至其 Kraken 帳戶，並請求存款/提款交易的即時狀態。

存款/提款在初始請求和交易完成之間會經過幾個階段，因此資金端點會根據呼叫時間返回不同的狀態值。

請注意，狀態值最初來自 Internet Financial Exchange Protocol (IFEX) 文件的第 16/17 頁，但這些值已稍作修改，以更適合加密貨幣交易（例如，並非所有可能的狀態值都已使用）。

存款

存款交易的可能狀態值如下：

•
Settled = 存款已收到，但仍需區塊鏈上的額外確認。
•
Success = 存款已達到區塊鏈上所需的確認數量。
•
Failure = 存款失敗（原因可能有多種）。

以下是一些 DepositStatus 端點回應中上述狀態值的範例：

Settled 狀態:{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"QSB7IFM-Q3LT3X-NVAOKE","txid":"92c908ea2ea819d678d67130e4d20b625a8f97f3cfff45f906dde8cef41a046a","info":"D7SLwMBPqfFMCZ8EJDMoVEePpZAFFegLt8","amount":"997.00000000","fee":"0.00000000","time":1611308478,"status":"Settled"}]}

Success 狀態:{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"QSB7IFM-Q3LT3X-NVAOKE","txid":"92c908ea2ea819d678d67130e4d20b625a8f97f3cfff45f906tdde8cef41a046a","info":"D7SLwMBPqfFMCZ8EJDMoVEePpZAFFegLt8","amount":"997.00000000","fee":"0.00000000","time":1611308478,"status":"Success"}]}

提款

提款交易的可能狀態值如下：

•
Initial = 提款請求已收到並正在檢查其有效性（例如帳戶上的任何資金限制）。
•
Pending = 提款正在等待我們的資金閘道處理。
•
Settled = 提款已發送到區塊鏈（此時區塊鏈交易 ID 將可用）。
•
Success = 提款交易在區塊鏈上至少有 1 次確認。
•
On hold = 提款已被暫停，必須由我們的資金團隊手動檢查。
•
Failure = 提款失敗（原因可能有多種）。

以下是一些 WithdrawStatus 端點回應中上述狀態值的範例：

Initial 狀態:{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"ASBCMYC-F5ETQT-34NMWT","txid":null,"info":"DGNBPsa2GhhtZGEZo79uF3WN2bTxFxmc9y","amount":"98.00000000","fee":"2.00000000","time":1612782924,"status":"Initial"}]}

Pending 狀態:{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"ASBCMYC-F5ETQT-34NMWT","txid":null,"info":"DGNBPsa2GhhtZGEZo79uF3WN2bTxFxmc9y","amount":"98.00000000","fee":"2.00000000","time":1612782924,"status":"Pending"}]}

Settled 狀態:{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"ASBCMYC-F5ETQT-34NMWT","txid":"064536e901f2cbfa6e279aa7a87c700b64e0ce561bf6e266788c47496f75106c","info":"DGNBPsa2GhhtZGEZo79uF3WN2bTxFxmc9y","amount":"98.00000000","fee":"2.00000000","time":1612782924,"status":"Settled"}]}

Success 狀態:{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"ASBCMYC-F5ETQT-34NMWT","txid":"064536e901f2cbfa6e279aa7a87c700b64e0ce561bf6e266788c47496f75106c","info":"DGNBPsa2GhhtZGEZo79uF3WN2bTxFxmc9y","amount":"98.00000000","fee":"2.00000000","time":1612782924,"status":"Success"}]}

Failure 狀態:{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"ASBCMYC-F5ETQT-34NMWT","txid":null,"info":"DGNBPsa2GhhtZGEZo79uF3WN2bTxFxmc9y","amount":"98.00000000","fee":"2.00000000","time":1612782924,"status":"Failure","status-prop":"canceled"}]}

有關存款/提款的更多資訊，請參閱我們的現金資金和加密貨幣資金支援頁面。

如何使用 REST API 交易端點檢索歷史時間和銷售（交易歷史）

REST API OHLC 端點僅提供有限的歷史數據，具體來說是所請求時間間隔的 720 個數據點。例如，請求 1 分鐘間隔的 OHLC 數據將返回最近 720 分鐘（12 小時）的數據。

對於需要額外 OHLC 或 tick 數據的應用程式，可以透過 REST API 交易端點檢索我們市場的整個交易歷史（歷史時間和銷售）。然後可以從歷史時間和銷售數據創建任何時間範圍和任何間隔的 OHLC。

交易端點接受一個名為 since 的可選參數，該參數指定數據的起始日期/時間。since 值是一個納秒級解析度的 UNIX 時間戳（一個標準的秒級 UNIX 時間戳，帶有 9 個額外數字）。

例如，對交易端點的呼叫，例如 https://api.kraken.com/0/public/Trades?pair=xbtusd&since=1559347200000000000 將返回從 2019 年 6 月 1 日 00:00:00 UTC 開始的 XBT/USD 歷史時間和銷售：

{"error":[],"result":{"XXBTZUSD":[["8552.90000","0.03190270",1559347203.7998,"s","m",""],["8552.90000","0.03155529",1559347203.8086,"s","m",""],["8552.90000","0.00510797",1559347203.9664,"s","m",""],["8552.90000","0.09047336",1559347203.9789,"s","m",""],["8552.90000","0.00328738",1559347203.9847,"s","m",""],["8552.90000","0.00492152",1559347203.9897,"s","m",""],["8552.90000","0.00201848",1559347203.9937,"s","m",""],["8552.90000","0.11422068",1559347203.9993,"s","m",""],["8552.90000","0.00425858",1559347204.071,"s","m",""],["8552.90000","0.00427679",1559347204.0762,"s","m",""],["8552.90000","0.06381401",1559347204.1662,"s","m",""]
...
["8579.50000","0.05379597",1559350785.248,"s","l",""],["8579.50000","0.94620403",1559350785.2936,"s","l",""],["8578.10000","0.45529068",1559350785.297,"s","l",""]],"last":"1559350785297011117"}}

後續對交易端點的呼叫應將 since 參數的值替換為上次呼叫結果中的 last 參數值，例如 https://api.kraken.com/0/public/Trades?pair=xbtusd&since=1559350785297011117。

使用特殊的 since 值 0（零）將返回從市場開始（從第一筆交易開始）的歷史時間和銷售。

如何使用用戶參考編號下單、查看和取消訂單

用戶參考編號是客戶提供的訂單 ID，可用於某些訂單管理任務（特別是取消訂單）中，以取代實際（API 提供）的訂單 ID。

用戶參考編號的實施盡可能靈活，因此可以用多種不同方式使用，包括：

•
作為唯一 ID（每個訂單都有不同的用戶參考編號），
•
將相關訂單分組（例如將不同槓桿水平的訂單分組），
•
或作為備用 ID，以防實際訂單 ID 未知。

用戶參考編號必須是介於 1 到 2,147,483,647 之間的數值（本質上是任何正 32 位數字），因此可以實施為簡單的計數器、隨機的帶符號 32 位值，甚至是秒級時間戳（儘管這將在 2038 年 1 月 19 日 3:14:07 UTC 之後失效）。

使用用戶參考編號下單

可以透過呼叫 AddOrder 端點並包含 userref 參數，將用戶參考編號作為值來下單：

$ ./krakenapi AddOrder pair=xdgusd type=buy ordertype=limit price=0.1 volume=50 userref=27649653

{"error":[],"result":{"descr":{"order":"buy 50.00000000 XDGUSD @ limit 0.1000000"},"txid":["OQJSXE-F5FOM-IXHVL4"]}}

查看帶有用戶參考編號的訂單

可以透過呼叫 Open/Closed/QueryOrders 端點並包含 userref 參數，將現有的用戶參考編號作為值來查看已附加用戶參考編號的訂單（在此情況下，用戶參考編號充當篩選器，僅顯示相關訂單）：

$ ./krakenapi OpenOrders userref=27649653

{"error":[],"result":{"open":{"OQJSXE-F5FOM-IXHVL4":{"refid":null,"userref":27649653,"status":"open","opentm":1629618802.9812,"starttm":0,"expiretm":0,"descr":{"pair":"XDGUSD","type":"buy","ordertype":"limit","price":"0.1000000","price2":"0","leverage":"none","order":"buy 50.00000000 XDGUSD @ limit 0.1000000","close":""},"vol":"50.00000000","vol_exec":"0.00000000","cost":"0.000000000","fee":"0.000000000","price":"0.000000000","stopprice":"0.000000000","limitprice":"0.000000000","misc":"","oflags":"fciq"}}}}

$ ./krakenapi ClosedOrders userref=38695724

{"error":[],"result":{"closed":{"O7YEFN-3V4RK-FBNSNM":{"refid":null,"userref":38695724,"status":"canceled","reason":"User requested","opentm":1629619539.3593,"closetm":1629619542.2246,"starttm":0,"expiretm":0,"descr":{"pair":"XBTUSD","type":"buy","ordertype":"limit","price":"25000.0","price2":"0","leverage":"none","order":"buy 0.00010000 XBTUSD @ limit 25000.0","close":""},"vol":"0.00010000","vol_exec":"0.00000000","cost":"0.00000","fee":"0.00000","price":"0.00000","stopprice":"0.00000","limitprice":"0.00000","misc":"","oflags":"fciq"}},"count":1}}

取消帶有用戶參考編號的訂單

可以透過呼叫 CancelOrder 端點並使用用戶參考編號作為 txid 值（取代訂單 ID 值）來取消已附加用戶參考編號的訂單：

$ ./krakenapi CancelOrder txid=16764529

{"error":[],"result":{"count":1}}

請注意，所有具有相同用戶參考編號的未結訂單都將被取消，因此可以透過單次 CancelOrder 呼叫同時取消多個訂單（如下列回應中 count 值為 3 所示）：

$ ./krakenapi CancelOrder txid=48695624

{"error":[],"result":{"count":3}}

為什麼我在使用 Kraken API 時收到 403 錯誤？

此問題可能與 Cloudflare 有關：

https://support.cloudflare.com/hc/en-us/articles/200169226-Why-am-I-getting-a-403-error-

注意：Kraken 已啟用「瀏覽器完整性檢查」。

如果您的請求包含可疑標頭，則可能會發生此情況。例如，您的請求可能缺少用戶代理，或使用非標準用戶代理；因此請檢查您的請求標頭。

如果您無法創建我們系統允許的任何標準請求，請將您嘗試的請求的完整副本發送給我們，包括您的 IP 地址和所有標頭。此資訊將有助於我們進一步調查。

Kraken 是否提供 API 測試環境？

期貨 API

對於我們的期貨 REST 和 WebSocket API (futures.kraken.com)，我們提供一個使用 API URL demo-futures.kraken.com 的完整測試環境。

REST、WebSocket 及 FIX 測試環境

對於我們的現貨 REST/WebSocket API 和 FIX API，我們目前為合資格客戶提供測試環境。存取此環境需要一個入門流程，您可以直接聯絡 API 團隊以開始此流程。

使用 Validate 測試參數測試我們的 API

透過 REST API AddOrder 或 WebSocket API addOrder 端點下單時，可以使用 validate 輸入參數來模擬訂單。

呼叫 AddOrder/addOrder 並將 validate 參數設為 true（validate=1、validate=true、validate=anything 等）將導致訂單詳情被檢查是否有錯誤，但 API 回應將永遠不會包含訂單 ID（在沒有 validate 參數的成功訂單中，訂單 ID 總是會被傳回）。

使用 validate 參數的 AddOrder 呼叫範例（請注意缺少訂單 ID）：

Bash

$ ./krakenapi AddOrder pair=xdgusd type=buy ordertype=market volume=5000 validate=true{"error":[],"result":{"descr":{"order":"buy 5000.00000000 XDGUSD @ market"}}}

小額真實訂單及/或價格極端的訂單

為了使用 Validate 參數進行全面的 API 測試，我們建議下達非常小的市價單（最小訂單規模的訂單），或遠離當前市場價格的限價單（例如，當市價為 200 美元時，下達以 800 美元出售 ETH/USD 的限價單）。

使用真實訂單進行測試可讓您的 API 代碼在真實世界條件下與我們的 API 互動，因此測試的每個方面都將準確（例如您的訂單如何影響訂單簿）。

可能影響您的 API 連線的 TLS 升級

基於安全原因，我們最近已停止支援 TLS 1.0 和 1.1。如果您在嘗試連接我們的 API 時遇到 SSL/TLS 連線錯誤訊息，很可能是由於使用了這些已棄用的標準之一。您需要修改您的 API 客戶端以強制使用 TLS 1.2/1.3，或將您的 .NET 版本升級到 4.6 或更高版本，該版本將 TLS 1.2/1.3 作為標準使用。

REST API 認證計算器 (Google 表格)

以下 Google 表格可用於計算任何輸入數據組合的REST API 認證簽名：