如何使用BitFinex的REST API？

Bitfinex的REST API使您可以通過編程方式進行交易，獲取市場數據並管理您的帳戶；本指南提供了有效使用的步驟和示例。

2025/04/14 03:35

使用BitFinex的REST API使您可以通過編程交互方式進行交流，從而使您可以執行諸如交易，檢索市場數據和管理帳戶之類的任務。本指南將引導您完成基本步驟，並提供有關如何有效使用Bitfinex的REST API的詳細說明。

Bitfinex的REST API入門

在開始使用Bitfinex的REST API之前，您需要設置一個API鍵。為此，請執行以下步驟：

• 登錄到您的Bitfinex帳戶。
• 導航到“帳戶”部分，然後選擇“ API”。
• 單擊“新密鑰”以生成新的API鍵。
• 選擇要授予鍵的權限，例如交易，提款或僅閱讀訪問權限。
• 確認鍵的創建，並安全地存儲API密鑰和秘密。

擁有API密鑰和秘密後，您可以開始向Bitfinex REST API提出請求。 API使用HTTPS並支持JSON進行數據交換。

身份驗證和安全性

身份驗證對於確保您的API相互作用至關重要。 Bitfinex使用API​​鍵的組合和使用API​​秘密生成的簽名。這是對您的請求進行身份驗證的方法：

• 生成一個nonce ：一個確保每個請求都是唯一的唯一數字。這可以是時間戳或增加整數。
• 創建有效載荷：將API路徑，NONCE和任何其他參數組合到JSON對像中。
• 生成簽名：使用您的API秘密使用HMAC-SHA384算法來簽名有效載荷。
• 包括標題：將API鍵，有效載荷和簽名添加到您的請求標題中。

這是如何在Python中創建必要標題的示例：

 import time
 import json
 import hmac
 import hashlib api_key ='your_api_key'
 api_secret ='your_api_secret'.encode（）




生成nonce
 nonce = str（int（time.time（） * 1000））



創建有效載荷
有效載荷= {



'request': '/v1/balance', 'nonce': nonce
 }
 
將有效載荷轉換為JSON並編碼
payload_json = json.dumps（有效載荷）.encode（）
 
生成簽名
簽名= hmac.new（api_secret，payload_json，hashlib.sha384）.hexdigest（）
 
準備標題
標題= {
 
'X-BFX-APIKEY': api_key, 'X-BFX-PAYLOAD': payload_json.decode(), 'X-BFX-SIGNATURE': signature
 }

提出API請求

有了身份驗證，您現在可以提出Bitfinex的REST API請求。這是一些常見的終點以及如何使用它們：

• 檢索帳戶餘額：使用/v1/balances端點檢查您的帳戶餘額。

 import requests url ='https://api.bitfinex.com/v1/balances'
響應= requests.get（url，標頭=標題）
打印（response.json（））

• 下訂單：使用/v1/order/new端點下訂單。您需要指定符號，金額，價格和訂單類型。

 payload = { 'request': '/v1/order/new', 'nonce': nonce, 'symbol': 'btcusd', 'amount': '0.01', 'price': '10000', 'exchange': 'bitfinex', 'type': 'exchange limit', 'side': 'buy'

}

payload_json = json.dumps（有效載荷）.encode（）
簽名= hmac.new（api_secret，payload_json，hashlib.sha384）.hexdigest（）

標題= {

'X-BFX-APIKEY': api_key, 'X-BFX-PAYLOAD': payload_json.decode(), 'X-BFX-SIGNATURE': signature

}

url ='https://api.bitfinex.com/v1/order/new'
響應= requests.post（url，標頭=標題）
打印（response.json（））

• 檢索市場數據：使用/v1/pubticker端點獲取特定交易對的當前股票。

 url = 'https://api.bitfinex.com/v1/pubticker/btcusd'
 response = requests.get(url)
 print(response.json())

處理錯誤和響應

使用BitFinex REST API時，正確處理錯誤並正確解釋響應很重要。這裡有一些提示：

• 檢查HTTP狀態代碼：200個狀態代碼表示成功的請求，而其他代碼表示錯誤。
• 解析響應JSON ：響應將包含帶有請求的數據或錯誤消息的JSON對象。
• 常見錯誤代碼：熟悉常見錯誤代碼，例如400（不良請求），401（未經授權）和500（內部服務器錯誤）。

這是如何處理Python中錯誤的示例：

 import requests url ='https://api.bitfinex.com/v1/balances'
響應= requests.get（url，標頭=標題）




如果響應。 STATUS_CODE== 200：



print('Request successful:', response.json())
別的：
 
print('Error:', response.status_code, response.text)
使用Websocket進行實時數據
雖然REST API適用於許多任務，但使用WebSockets可以提供實時數據更新。要連接到Bitfinex的Websocket API，請按照以下步驟：
 
建立Websocket連接：使用Python中的websocket-client類的WebSocket庫。
 import websocket
 ws = websocket.websocket（）
 ws.connect（'wss：//api-pub.bitfinex.com/ws/2'）

• 訂閱頻道：發送JSON消息以訂閱特定渠道，例如股票或訂單簿更新。

 subscribe_msg = { 'event': 'subscribe', 'channel': 'ticker', 'symbol': 'tBTCUSD'

}

ws.send（json.dumps（subscribe_msg））

• 流程傳入消息：解析傳入的JSON消息以處理實時數據。

 result = ws.recv()
 print(result)

管理API率限制

Bitfinex對API請求施加了限制，以防止濫用。有效地管理這些限制：

• 了解限制：Bitfinex對於身份驗證和未經身份驗證的請求具有不同的速率限制。經認證的請求通常限制為每分鐘90個請求。
• 在您的代碼中實現速率限制：使用Python中的ratelimit之類的庫來確保您保持範圍。

 from ratelimit import limits, sleep_and_retry @sleep_and_retry
 @limits（呼叫= 90，週期= 60）
 def call_api（）：




# Make your API call here pass
使用該功能
call_api（）

常見問題

問：我可以使用Bitfinex的REST API來自動交易策略嗎？

答：是的，您可以使用REST API通過編程下訂單，檢查餘額和檢索市場數據來自動化交易策略。確保您實施適當的錯誤處理和限制費率以保持穩定的交易環境。

問：是否可以使用Bitfinex REST API提取資金？

答：是的，您可以使用/v1/withdraw端點提取資金。您需要指定提款方法，金額和地址。確保您在API密鑰上具有必要的權限以執行提款。

問：如何在不影響我的實時帳戶的情況下測試我的API請求？

答：BitFinex提供了測試網絡環境，您可以在其中測試API請求而不會影響您的實時帳戶。您可以註冊一個TestNet帳戶，並使用TestNet API端點來模擬交易和其他操作。

問：如果遇到身份驗證錯誤，該怎麼辦？

答：如果遇到身份驗證錯誤，請仔細檢查API密鑰，秘密和簽名生成過程。確保每個請求的nonce都是唯一的，並且有效載荷正確格式化。如果問題持續存在，請考慮再生您的API密鑰和秘密。