透過 API 進行資金操作

上次更新時間： 2025年3月31日

簡介

我們的 REST API 提供多個資金端點，可讓您完成以下存款/提款相關任務：

  • •

    擷取/建立存款地址

  • •

    查看存款交易狀態

  • •

    請求提款（至已核准的地址/帳戶）

  • •

    查看提款交易狀態

REST API 資金端點均為私人（已驗證）端點，因此必須使用 HTTP POST 方法呼叫，並且必須在 HTTP 標頭中包含有效的驗證值。

用於資金請求的 API 金鑰必須包含特定權限，具體取決於金鑰是唯讀（僅允許查看資金交易）還是完全存取（允許查看和請求資金交易）。

範例

以下是每個 REST API 資金端點的範例（使用我們的REST API 命令列客戶端）：

DepositMethods（存款方法）

% ./krakenapi DepositMethods asset=doge{"error":[],"result":[{"method":"Dogecoin","limit":false,"gen-address":true}]}

DepositAddresses（存款地址） (沒有可用的存款地址)

% ./krakenapi DepositAddresses asset=doge method=Dogecoin{"error":[],"result":[]}

DepositAddresses（存款地址） (建立新的存款地址)

% ./krakenapi DepositAddresses asset=doge method=Dogecoin new=true{"error":[],"result":[{"address":"DFSHkVSQycPZDu8CkiNvx8ymHKHoMLteUD","expiretm":"0","new":true}]}

DepositStatus（存款狀態） (原生網路存款)

% ./krakenapi DepositStatus asset=doge{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"QSBALMX-YTM4MI-REMLWN","txid":"f0cf9b21eeabb87cd240b61ce813490bf03ae96427f5874a55768e7299a9ac9c","info":"DFSHkVSQycPZDu8CkiNvx8ymHKHoMLteUD","amount":"95.00000000","fee":"0.00000000","time":1676727227,"status":"Success"}]}

DepositStatus（存款狀態） (ERC20 網路存款)

% ./krakenapi DepositStatus asset=usdc{"error":[],"result":[{"method":"USDC","aclass":"currency","asset":"USDC","refid":"Q4FTRAH-KPUTB7-ATW3UH","txid":"0x2756a446fa1bd75c4bb84b151a12456e52e0a65ff0aa5f35d7231cd25856058b","info":"0xc2ed795f33ed0b8b43fa8165de0107438237161e","amount":"10.00000000","fee":"0.00000000","time":1679452779,"status":"Success","originators":["0x9d7f5e4b07d8f3fb9456128191e4bc517d3d706da1b1dcf52037d0c93ecae3cc"]}]}

請注意，額外的 originators 欄位提供了原始（客戶端到 Kraken）交易 ID，而不是 txid 欄位提供的內部（Kraken 到 Kraken）交易 ID。

WithdrawInfo（提款資訊）

% ./krakenapi WithdrawInfo asset=doge key=XDG_Wallet amount=100{"error":[],"result":{"method":"XXDG","limit":"100.00000000","amount":"96.00000000","fee":"4.00000000"}}

Withdraw（提款）

% ./krakenapi Withdraw asset=doge key=XDG_Wallet amount=100 {"error":[],"result":{"refid":"ASBG2IX-OQZTG5-CRWGN3"}}

WithdrawStatus（提款狀態）

% ./krakenapi WithdrawStatus asset=doge{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"ASBG2IX-OQZTG5-CRWGN3","txid":"86b9bbee8775793d0ef420e3c374a2e7913ad8ba9e1a4939cf3044a09c533e44","info":"DNtxrbNnPWf9RZQMYcrqLL6QRgHoozabwM","amount":"96.00000000","fee":"4.00000000","time":1676713821,"status":"Success"}]}

WithdrawCancel（取消提款） (如果可能)

% ./krakenapi WithdrawCancel asset=doge refid=ASBTV5V-STE7C7-MIQUAC{"error":[],"result":true}

失敗範例

以下是一些失敗的資金請求範例，顯示可能收到的錯誤訊息：

DepositAddresses（存款地址） (沒有有效的 method 參數)

% ./krakenapi DepositAddresses asset=doge method=invalid {"error":["EFunding:No funding method"]}

WithdrawInfo（提款資訊） (在 key 參數中使用不正確的描述)

% ./krakenapi WithdrawInfo asset=doge key=invalid amount=100{"error":["EFunding:Unknown withdraw key"]}

Withdraw（提款） (使用沒有所需受益人/收款人資訊的地址)

% ./krakenapi Withdraw asset=btc key=BTC_Wallet amount=1.5{"error":["EGeneral:Invalid arguments:beneficiary_recipient"]}

請注意，目前僅對加拿大帳戶的特定提款要求受益人/收款人資訊。

WithdrawCancel（取消提款） (針對已在處理中的提款)

% ./krakenapi WithdrawCancel asset=doge refid=ASBG2IX-OQZTG5-CRWGN3 {"error":["EFunding:Invalid reference id"]}

需要更多幫助？