如何使用Bitfinex的API查詢帳戶餘額？

使用BitFinex的API來查詢帳戶餘額，通過使用API​​鍵進行身份驗證，構建對/v2/auth/r/錢包的POST請求以及解析JSON響應。

2025/04/13 15:21

如何使用Bitfinex的API查詢帳戶餘額？

Bitfinex是領先的加密貨幣交換之一，提供了強大的API，允許用戶編程與其平台進行交互。用戶執行的最常見操作之一是查詢帳戶餘額。本文將指導您完成使用Bitfinex的API檢查您的帳戶餘額的過程，以確保您可以有效，安全地管理資金。

了解Bitfinex的API身份驗證

在查詢帳戶餘額之前，您需要了解如何驗證API請求。 Bitfinex使用API​​鍵和簽名的組合來確保安全訪問您的帳戶。

• 生成API鍵：登錄您的BitFinex帳戶，導航到API部分，然後生成新的API密鑰。確保為閱讀帳戶餘額提供必要的權限。
• API密鑰和秘密：您將收到一個API密鑰和一個秘密密鑰。保持秘密密鑰安全，永遠不要分享。
• 創建簽名：對於每個API請求，您需要使用秘密鍵創建一個簽名。簽名是通過使用秘密密鑰哈希請求有效載荷生成的。

建立您的開發環境

要與Bitfinex的API進行互動，您需要設置開發環境。這是這樣做的方法：

• 選擇一種編程語言：Bitfinex的API可以與各種編程語言一起使用。流行的選擇包括Python，JavaScript和Ruby。
• 安裝所需的庫：例如，如果選擇Python，則可以使用requests庫來製作HTTP請求， hmac以及hashlib來創建簽名。
• 設置API憑據：將API密鑰和秘密密鑰存儲在您的開發環境中。

構建API請求

要查詢您的帳戶餘額，您需要將API請求構建到適當的端點。為此，BitFinex提供/v2/auth/r/wallets端點。

• 端點： https://api.bitfinex.com/v2/auth/r/wallets
• HTTP方法： POST
• 有效載荷：用於此請求的空數組[] 。

創建簽名

創建簽名是對您的請求進行身份驗證的關鍵步驟。這是這樣做的方法：

• 時間戳：以毫秒為單位生成時間戳。該時間戳必須包含在有效載荷中。
• NONCE ：使用時間戳作為NONCE來確保請求是唯一的。
• 有效載荷：通過串聯API路徑和JSON編碼有效載荷來構建有效載荷。
• 簽名：使用HMAC-SHA384算法使用您的秘密鑰匙和有效載荷創建簽名。

這是如何在Python中創建簽名的示例：

 import time
 import json
 import hmac
 import hashlib api_key ='your_api_key'
 api_secret ='your_api_secret'




產生時間戳和nonce
時間戳= str（int（time.time（） * 1000））
 nonce =時間戳



構建有效載荷
有效載荷='/api/v2/auth/r/錢包' + json.dumps（[]）



創建簽名
signature = hmac.new（api_secret.encode（），payload.encode（），hashlib.sha384）.hexdigest（）

發送API請求

構建有效載荷並創建簽名後，您可以發送API請求。這是在Python中做到這一點的方法：

• 標題：在請求的標題中包括API鍵，簽名和NON。
• 發送請求：使用requests庫將郵政請求發送到端點。

這是如何在Python發送請求的示例：

 import requests url ='https://api.bitfinex.com/v2/auth/r/wallets'




標題= {



'bfx-nonce': nonce, 'bfx-apikey': api_key, 'bfx-signature': signature
 }
 
響應= requests.post（url，headers =標題，data = json.dumps（[]））
 
如果響應。 STATUS_CODE== 200：
 
print(response.json())
別的：
 
print('Error:', response.status_code, response.text)
解析響應
發送請求後，您需要解析響應以提取您的帳戶餘額。 Bitfinex的響應將以JSON格式為JSON，其中包含一系列錢包對象。
 
錢包對象：每個錢包對像都包含貨幣，平衡和類型的信息（例如，交換或邊距）。
提取餘額：通過數組迭代以提取每種貨幣的餘額。
這是如何解析python中的響應的一個示例：
 
wallets = response.json()
對於錢包中的錢包：
 
currency = wallet[1] balance = wallet[2] print(f'Currency: {currency}, Balance: {balance}')
處理錯誤和邊緣案件
查詢帳戶餘額時，處理潛在錯誤和邊緣案例很重要：
 
API速率限制：BitFinex在API請求上具有速率限制。確保您不會超過這些限制以避免被阻塞。
身份驗證錯誤：如果您的簽名或非CE不正確，則會收到身份驗證錯誤。仔細檢查您的身份驗證過程。
網絡問題：準備處理與網絡相關的問題，例如超時或連接錯誤。
常見問題
問：我可以使用相同的API密鑰查詢多個帳戶的帳戶餘額嗎？
 
答：不，每個API鍵都與一個帳戶綁定。要查詢多個帳戶的餘額，您需要為每個帳戶生成單獨的API鍵。
 
問：我多久可以使用Bitfinex的API查詢一次帳戶餘額？
 
答：Bitfinex對API請求施加了速率限制。您通常可以每分鐘最多彌補90個請求，但是最好檢查Bitfinex API文檔中的當前限制。
 
問：當查詢帳戶餘額時遇到身份驗證錯誤，該怎麼辦？
 
答：身份驗證錯誤通常是由於簽名或非CE值不正確而發生的。確保您的時間戳準確，並使用正確的秘密鍵來生成簽名。如果問題仍然存在，請重新生成您的API鍵，然後重試。
 
問：我可以使用Bitfinex的API實時查詢帳戶餘額嗎？
 
答：Bitfinex的API不提供帳戶餘額的實時流。您需要定期向/v2/auth/r/wallets端點提出請求，以獲得最新的餘額。