All
篩選條件:
我該如何將現金存入我的帳戶當中?
我需要帳戶驗證方面的幫助
為甚麼我無法訪問我的帳戶?
提取加密貨幣會產生任何費用嗎?
我需要協助登錄我的帳戶
使用REST API 資金 API端點,客戶可以將資金充值至其 Kraken 帳戶或從中提款,並請求充值/提款交易的即時狀態。
充值/提款從最初提出請求到交易完成,期間會經過多個階段。因此,資金 API端點會根據呼叫時機返回不同的狀態值。
請注意,這些狀態值最初來自互聯網金融交易協議(IFEX)文件第 16/17 頁,但相關值經過輕微修改,以更適合加密貨幣交易(例如並非所有可能的狀態值都會使用)。
充值交易可能出現的狀態值如下:
已結算=充值已收到,但仍需在區塊鏈上取得額外確認。
成功 =充值已在區塊鏈上取得所需數量的確認。
失敗 =充值失敗(原因可能有多種)。
以下是上述狀態值在 DepositStatus API端點回應中顯示的部分例子:
已結算狀態:{"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"}]}
成功狀態:{"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"}]}
提款交易可能出現的狀態值如下:
初始 =提款請求已收到,正在檢查其有效性(例如帳戶是否有任何資金限制)。
待處理 =提款正在等待由我們的資金閘道處理。
已結算=提款已發送至區塊鏈(此時可以取得區塊鏈交易 ID)。
成功 =提款交易已在區塊鏈上取得至少 1 次確認。
凍結中 =提款已凍結,由我們的資金團隊進行手動檢查。
失敗 =提款失敗(原因可能有多種)。
以下是上述狀態值在 WithdrawStatus API端點回應中顯示方式的部分示例:
初始狀態:{"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"}]}
待處理狀態:{"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"}]}
已結算狀態:{"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"}]}
成功狀態:{"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"}]}
失敗狀態:{"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 的 OHLC API端點只提供有限的歷史資料,具體而言,是所要求時間間隔的 720 個資料點。例如,要求以 1 分鐘間隔取得 OHLC 資料,會傳回最近 720 分鐘(12 小時)的資料。
如應用程式需要額外的 OHLC 或 tick 資料,你可以透過 REST API Trades API端點,取得我們市場的完整交易歷史紀錄(歷史時間及成交資料)。然後,你可以根據歷史時間及成交資料建立任何時間範圍及任何時間間隔的 OHLC。
Trades API端點接受名為 since 的可選參數,用於指定資料的開始日期/時間。since 值是納秒精度的 UNIX timestamp(以秒為單位的標準 UNIX timestamp,並額外加上 9 位數字)。
例如,對 Trades API端點發出以下請求 https://api.kraken.com/0/public/Trades?pair=xbtusd&since=1559347200000000000,會傳回 XBT/USD 於 2019年6月1日 00:00:00 UTC 起的歷史時間及成交資料:
{"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"}}
之後對 Trades API端點發出的請求,應以上一次請求結果中的 last 參數值取代 since 參數值 例如 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 位元數值,甚至是以秒為單位的 timestamp(不過在 2038年1月19日 3:14:07 UTC 後便會失效)。
你可以透過呼叫 AddOrder API端點,並加入以使用者參考編號作為值的 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 API端點,並在 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 API端點,並將使用者參考編號用作 txid 值(取代訂單 ID 值):
$ ./krakenapi CancelOrder txid=16764529
{"error":[],"result":{"count":1}}
請注意,所有具有相同使用者參考編號的未成交訂單都會被取消,因此你可以透過一次 CancelOrder 呼叫同時取消多張訂單(如下方回應中的 count 值為 3 所示):
$ ./krakenapi CancelOrder txid=48695624
{"error":[],"result":{"count":3}}
此問題可能與 Cloudflare 有關:
https://support.cloudflare.com/hc/en-us/articles/200169226-Why-am-I-getting-a-403-error-
注意:Kraken 已啟用 "Browser Integrity Check"。
如果你的請求包含可疑的標頭,便可能出現此問題。例如,你的請求可能缺少 user agent,或使用非標準的 user agent;因此,請檢查你的請求標頭。
如果你未能建立系統允許的任何標準請求,請向我們發送你嘗試提交的完整請求副本,包括你的 IP 位址及所有標頭。這些資料有助我們作進一步調查。
對於現貨 REST/WebSocket API 及 FIX API,以及衍生品 REST/WebSocket API 和 FIX API,我們目前為合資格客戶提供測試環境。你需要完成 onboarding 流程才能存取此環境,而該流程可以直接聯絡 API 團隊開始。
透過 REST API 的 AddOrder 或 WebSocket API 的 addOrder API端點下單時,可以使用 validate 輸入參數模擬訂單。
呼叫 AddOrder/addOrder 並將 validate 參數設定為 true(validate=1、validate=true、validate=anything 等),會檢查訂單詳細資料是否有錯誤,但 API 回應永遠不會包含訂單 ID(如果成功下單時沒有使用 validate 參數,則一定會返回訂單 ID)。
使用 AddOrder 呼叫及 validate 參數的例子(請注意缺少訂單 ID):
Bash
$ ./krakenapi AddOrder pair=xdgusd type=buy ordertype=market volume=5000 validate=true{"error":[],"result":{"descr":{"order":"buy 5000.00000000 XDGUSD @ market"}}}小額真實訂單及/或價格極端的訂單
如要使用 Validate Parameter 進行全面的 API 測試,我們建議你下非常小額的市價訂單(即最低訂單數量的訂單),或下單價遠離目前市場價格的限價訂單(例如,市場價格為 200 美元時,以 800 美元的價格下單出售 ETH/USD)。
使用真實訂單進行測試,可讓你的 API 程式碼在實際環境中與我們的 API 互動,因此測試的每個部分都會準確反映實際情況(例如你的訂單如何影響訂單簿等)。
基於安全理由,我們最近已停止支援 TLS 1.0 及 1.1。如果你在嘗試連接我們的 API 時遇到 SSL/TLS 連接錯誤訊息,原因很可能是你使用了其中一種已棄用的標準。你需要修改 API 用戶端,強制使用 TLS 1.2/1.3,或將 .NET 版本升級至 4.6 或以上,因為該版本預設使用 TLS 1.2/1.3。
你可以使用以下 Google Sheet,為任何輸入資料組合計算REST API 身分驗證簽名:
API 私密(秘密)金鑰
API端點(Balance、TradeBalance、QueryOrders 等)
Nonce 值(如需更多詳情,請參閱我們的甚麼是 nonce客服支援頁面)
端點輸入參數(例如 asset=doge)
你可以使用計算器,確認身分驗證演算法是否已正確實作,從而避免在開發週期後期遇到潛在問題(尤其是意外的無效金鑰錯誤)。
在 Chrome(或任何其他近期的網絡瀏覽器)中開啟REST API 身分驗證計算器
透過檔案 -> 建立副本選單,將計算器複製到你自己的 Google Drive(進行此步驟時,你需要登入 Google 帳戶)
使用你自己的 API 金鑰及請求詳情,編輯 API 金鑰、API 端點、nonce 值及輸入資料欄位
將計算出的 API 身分驗證簽名與你自己的 API 程式碼計算出的值進行比較(兩個值必須完全一致)

使用我們的用戶端程式庫封裝器,主要好處是你不必花時間及精力重新建立 API 簽名,因為我們已經為你完成相關工作。
如果你只打算呼叫公開方法,則可以選擇不使用用戶端程式庫,因為這些方法不需要身分驗證。
你可以在這裏找到可用的封裝器。