如何訪問BYBIT合同的歷史交易數據？

了解BYBIT的歷史交易數據

BYBIT合同的歷史交易數據是指過去執行交易的記錄，包括價格，數量，時間戳，側面（買入/出售）和合同類型等信息。這些數據對於從事技術分析，進行回測策略或審核其交易績效的交易者至關重要。 BYBIT通過多種方法（包括其官方API和Web界面）提供對此數據的訪問。這些數據通常涵蓋BTCUSD，Ethusd等各種加密貨幣的永久合同和期貨合約。

區分公共貿易歷史和個人貿易歷史很重要。公共數據反映了訂單簿上執行的所有交易，並且可供任何用戶使用。個人貿易歷史記錄僅包括您的帳戶執行的交易，需要訪問身份驗證。通過API檢索兩種類型的數據，都以JSON格式構成，使其適合集成到分析工具中。

通過BYBIT API訪問公共貿易歷史

要檢索BYBIT合同的公共歷史貿易數據，請使用官方的BYBIT REST API端點：

• API端點： https://api.bybit.com/v5/market/recent-trade

該端點返回指定符號的最新交易。要訪問更深的歷史記錄，您必須使用每個響應中返回的光標參數進行分頁。這是提出請求的方法：

• 使用所需參數的HTTP獲取請求：
  • category ：設置為USDT合同的linear或反向合同的inverse
  • symbol ：指定合同，例如， BTCUSDT
  • limit ：每個請求的記錄數（最多1000）
  • cursor ：使用前面響應中的光標獲取下一批

python中的示例請求：

 import requests url ='https://api.bybit.com/v5/market/recent-trade' params = {



'category': 'linear', 'symbol': 'BTCUSDT', 'limit': 100
 }
 
響應= requests.get（url，params = params） data = reverse.json（）

返回的JSON包括價格，大小，側面，時間和符號等字段。要檢索舊數據，請從next_page_cursor字段中提取光標，並將其包含在下一個請求中。

使用API身份驗證檢索個人貿易歷史記錄

要訪問您的個人合同貿易歷史記錄，需要身份驗證。您必須從BYBIT帳戶設置中生成一個具有“訂單”和“讀取”權限的API密鑰。相關端點是：

• API端點： https://api.bybit.com/v5/order/execution-list

此端點返回與您的帳戶相關的填充合同訂單。必需的參數包括：

• category ： linear或inverse
• symbol ：例如， BTCUSDT
• start_time和end_time ：UNIX時間戳定義時間範圍
• limit ：每個請求最多50個記錄
• api_key ， timestamp和sign ：身份驗證標頭

生成請求的步驟：

• 在毫秒中產生時間戳
• 使用您的API秘密使用HMAC SHA256創建簽名
• 包括標題： X-BAPI-API-KEY ， X-BAPI-TIMESTAMP ， X-BAPI-SIGN

示例用於簽名的Python代碼：

 import hmac import time api_key ='your_api_key' api_secret ='your_api_secret'時間戳= str（int（time.time（） * 1000））



param_str = f'category =線性＆符號= btcusdt＆limit = 50＆start_time = 1700000000000＆end_time = 1701000000000'簽名= hmac.new（api_secret.encode（），param_str.encode（），digestmod ='sha256'）。 hexdigest（）



標題= {



'X-BAPI-API-KEY': api_key, 'X-BAPI-TIMESTAMP': timestamp, 'X-BAPI-SIGN': signature
 }
 
響應= requests.get（url，params = params，headers =標題）

每個記錄包括exec_price，exec_qty，side，Fee和order_id 。

將Bybit Web界面用於貿易歷史記錄

對於不願使用API的用戶，BYBIT提供了基於Web的界面來查看個人合同貿易歷史記錄。登錄到您的BYBIT帳戶並導航到：

• 衍生品→訂單→貿易歷史記錄

在這裡，您可以：

• 選擇線性合同或反合同
• 從下拉列表中選擇一個特定符號
• 按日期範圍進行過濾
• 一次以CSV格式導出多達100個記錄

顯示的列包括符號，側面，數量，價格，費用，封閉的PNL和時間。請注意，Web界面不允許一鍵單擊所有歷史數據的大量導出。您必須通過日期手動分頁，並在需要時下載多個CSV文件。

處理和存儲歷史數據

檢索後，應將歷史貿易數據存儲以進行分析。推薦格式包括CSV，Parquet或數據庫表。對於連續數據收集，請設置定期調用API並附加新記錄的CRON作業或腳本。

主要注意事項：

• 費率限制：BYBIT允許公共終點每分鐘60個請求，私人終點為120
• 數據刪除：使用exec_id或trade_time作為唯一標識符
• 時區處理：所有時間戳都在UTC中
• 數據保留：BYBIT在Web界面上保留長達6個月的個人貿易歷史

將數據存儲在結構化目錄中：

 /trade_data/ /public/ btcusdt_20231201.csv

/私人的/

my_trades_20231201.csv

使用Python中的Pandas合併和分析：

import pandas as pd

df = pd.read_csv（'btcusdt_20231201.csv'） df ['time'] = pd.to_datetime（df ['time']，unit ='ms'）

常見問題

Bybit的合同貿易歷史記錄有多遠？ BYBIT的公共API通常在recent-trade端點保留最多7天的貿易數據。對於較舊的公共數據，需要第三方聚合器或自定義數據收集腳本。通過私人API的個人貿易歷史可以追溯到幾個月，具體取決於創建日期和BYBIT的內部保留政策。

我可以獲取tick級歷史數據以進行回測嗎？是的， /v5/market/recent-trade端點提供刻度級數據，包括每次交易的價格和數量。要構建完整的刻度歷史記錄，您必須連續進行輪詢API或使用WebSocket流（ publicTrade主題）來捕獲實時交易並存儲它們。

訪問私人數據時，為什麼我會遇到“無效的簽名”錯誤？當HMAC簽名不匹配時，會發生此錯誤。確保按字母順序正確排序參數字符串，時間戳為毫秒，並且正確輸入了API秘密。還要驗證HTTP方法（GET/POST）與端點的預期格式匹配。

是否可用於過期的期貨合約？是的，可以通過指定合同活動期間使用的正確符號名稱來訪問過期期貨合約的歷史貿易數據。例如， BTCUSD231229用於2023年12月BTC逆期。適用相同的API端點，具有category=inverse和適當的符號。