如何在BYBIT上查看API交易記錄？交易數量是否有限制？

BYBIT的API允許用戶使用/v2/private/wallet/Transaction-log端點檢索事務記錄，並限制了速率和歷史數據訪問。

2025/05/19 07:07

BYBIT是一種流行的加密貨幣交易所，為希望自動化其交易策略或以編程方式管理其投資組合的交易者提供強大的API服務。用戶通常需要通過API訪問的關鍵功能之一是事務記錄。本文將指導您了解BYBIT上的API交易記錄的過程，並討論您可以檢索的交易數量可能存在的任何限制。

了解Bybit的API

在研究取回交易記錄的細節之前，必須了解BYBIT API的基礎知識。 BYBIT的API允許用戶編程與平台進行交互。這包括執行交易，管理訂單以及獲取各種數據，例如交易記錄。 API旨在安全有效，以確保用戶可以有效地管理其帳戶。

訪問API

要開始使用BYBIT的API，您需要設置一個API鍵。這是這樣做的步驟：

• 登錄到您的bybit帳戶。
• 導航到API管理部分。通常可以在帳戶設置或用戶配置文件部分下找到。
• 創建一個新的API鍵。您將需要根據需要提供鑰匙的名稱並設置權限。
• 保存API密鑰和秘密。這些將用於驗證您的API請求。

檢索交易記錄

設置API密鑰後，您可以開始提出請求以檢索事務記錄。 BYBIT的API提供了專門為獲取事務數據而設計的端點。您將使用的端點是/v2/private/pharet/transaction-log 。

這是向此端點請求的方法：

• 準備您的請求。您需要在請求標題中包含API密鑰和秘密才能對其進行身份驗證。
• 指定參數。您可以通過指定參數，例如currency ， start_date ， end_date和exec_type來過濾事務記錄。這些參數可幫助您將結果縮小到您感興趣的交易。
• 發送請求。使用諸如Postman之類的工具或在您喜歡的編程語言中編寫腳本以將請求發送到BYBIT的API服務器。

以下是使用requests庫中Python中請求的樣子的示例：

 import requests
 import time api_key ='your_api_key'
 api_secret ='your_api_secret'
 base_url ='https://api.bybit.com'
端點='/v2/private/wallet/transaction-log'




準備參數
params = {



'currency': 'BTC', 'start_date': '2023-01-01', 'end_date': '2023-01-31', 'exec_type': 'Deposit'
 }
 
生成時間戳
時間戳= int（time.time（） * 1000）
 
準備標題
標題= {
 
'Content-Type': 'application/json', 'api_key': api_key, 'timestamp': str(timestamp), 'sign': generate_signature(api_secret, timestamp, params) # You need to implement the generate_signature function
 }
 
發送請求
響應= requests.get（base_url +端點，標頭=標題，params = params）
 
處理響應
如果響應。 STATUS_CODE== 200：
 
print(response.json())
別的：
 
print(f'Error: {response.status_code}')
了解反應
當您成功檢索事務記錄時，BYBIT的API將返回包含請求數據的JSON響應。響應將包括id ， time ， currency ， amount ， type和status等字段。正確解析這些數據以理解您的交易歷史記錄很重要。
 
這是響應可能是什麼樣子的示例：
 
{
 'ret_code'：0，
 'ret_msg'：'OK'，
 'ext_code'：''，
 'ext_info'：''，
 '結果'： {
 
'data': [ { 'id': '123456', 'time': '2023-01-05T12:34:56Z', 'currency': 'BTC', 'amount': '0.1', 'type': 'Deposit', 'status': 'Success' }, { 'id': '123457', 'time': '2023-01-10T12:34:56Z', 'currency': 'BTC', 'amount': '0.2', 'type': 'Withdrawal', 'status': 'Success' } ]
 }
 }

交易記錄的限制

BYBIT對您可以通過API檢索的交易數量施加了一定的限制。這些限制是防止濫用的，並確保平台資源的公平用途。以下是要記住的一些關鍵點：

• 費率限制：BYBIT對API請求的利率限制。例如，您可能僅限於每分鐘或每天的一定數量的請求。超過這些限制可能會導致您的API密鑰暫時阻塞。
• 分頁：檢索交易記錄時，Bybit使用分頁來管理大型數據集。您可以指定limit參數以控制每個響應中返回的記錄數，並使用page參數瀏覽結果的多個頁面。
• 歷史數據：您可以檢索交易記錄的距離可能會有限。 BYBIT通常允許您在過去的一定天數或幾個月中獲取數據。

要有效地管理這些限制，您應該：

• 監視您的API使用情況。跟踪您要提出的請求數量，並確保您保持在速率限制範圍內。
• 實施分頁。使用limit和page參數在可管理的塊中檢索數據。
• 計劃您的數據檢索。如果您需要獲取大量的歷史數據，請仔細計劃您的請求，以免達到限制。

處理錯誤

使用Bybit的API時，您可能會遇到錯誤。常見錯誤包括身份驗證故障，超過速率限制和無效參數。這是處理這些錯誤的方法：

• 身份驗證錯誤：如果您收到身份驗證錯誤，請仔細檢查API密鑰和秘密。確保將它們正確包含在請求標題中。
• 費率限制錯誤：如果您超過速率限制，請等待一段時間，然後重試您的請求。實施代碼的延遲，以防止重複擊中速率限制。
• 無效參數：如果API由於無效參數返回錯誤，請查看您的請求並確保正確格式化所有參數並在可接受的範圍內。

常見問題解答

問：我可以使用BYBIT的API立即檢索多種貨幣的交易記錄嗎？

答：不，BYBIT的API要求您在檢索交易記錄時指定單個貨幣。如果您需要多種貨幣記錄，則需要為每種貨幣單獨提出API請求。

問：在檢索交易記錄時，如何確保我的API密鑰的安全性？

答：為了確保您的API密鑰的安全性，切勿與任何人共享，並僅在安全環境中使用它。此外，考慮使用BYBIT的IP白名單功能來限制API訪問特定IP地址的訪問。

問：是否有一種方法可以在時間表上自動取回交易記錄？

答：是的，您可以通過編寫按計劃提出API請求的腳本來自動化事務記錄的檢索。在基於UNIX的系統或Windows上使用CRON作業等調度工具，以定期運行腳本。

問：如果我遇到429個請求的錯誤，該怎麼辦？

答：如果遇到429錯誤，則意味著您已經超出了Bybit的速率限制。等待一段時間，然後重試您的請求，並考慮在代碼中實施延遲，以防止重複擊中速率限制。