バイビット契約の履歴取引データにアクセスする方法は？

BYBITは、APIまたはWebインターフェイスを介して過去の契約貿易データを提供し、永続的および先物契約のバックテストと分析を可能にします。

2025/08/13 11:36

BYBITに関する履歴取引データの理解

BYBIT契約の過去の取引データとは、価格、数量、タイムスタンプ、サイド（購入/販売）、契約タイプなどの情報を含む、実行された取引の過去の記録を指します。このデータは、テクニカル分析、バックテスト戦略、または取引パフォーマンスの監査に従事するトレーダーにとって不可欠です。 BYBITは、公式のAPIやWebインターフェイスなど、複数の方法を介してこのデータへのアクセスを提供します。データは通常、BTCUSD、Ethusdなどのさまざまな暗号通貨にわたる永続的な契約と先物契約をカバーしています。

公共貿易の歴史と個人貿易史を区別することが重要です。パブリックデータは、注文帳で実行されたすべての取引を反映しており、任意のユーザーが利用できます。個人の貿易履歴には、アカウントによって実行された取引のみが含まれ、アクセスするには認証が必要です。両方のタイプのデータは、APIを介して取得したときにJSON形式で構成されており、分析ツールへの統合に適しています。

Bybit APIを介して公共貿易履歴にアクセスします

バイビット契約の公的履歴貿易データを取得するには、公式のBYBit REST APIエンドポイントを使用します。

• APIエンドポイント： https://api.bybit.com/v5/market/recent-trade

このエンドポイントは、指定されたシンボルの最新の取引を返します。より深い履歴レコードにアクセスするには、各応答で返されるカーソルパラメーターを使用してページを付ける必要があります。リクエストの作成方法は次のとおりです。

• 必要なパラメーターを使用してHTTP GETリクエストを使用します。
  • 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
 }
 
Response = requests.get（url、params = params）
 data = response.json（）

返されたJSONには、価格、サイズ、サイド、時間、シンボルなどのフィールドが含まれています。古いデータを取得するには、 next_page_cursorフィールドからカーソルを抽出し、次のリクエストに含めます。

API認証を使用して個人貿易履歴を取得します

個人契約の取引履歴にアクセスするには、認証が必要です。 bybitアカウント設定から「注文」と「読み取り」権限を備えたAPIキーを生成する必要があります。関連するエンドポイントは次のとおりです。

• APIエンドポイント： https://api.bybit.com/v5/order/execution-list

このエンドポイントは、アカウントに関連付けられた契約注文を返します。必要なパラメーターは次のとおりです。

• category ： linearまたはinverse
• symbol ：例、 BTCUSDT
• start_time and 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 = linear＆symbol = btcusdt＆limit = 50＆start_time = 1700000000000＆end_time = 1701000000000 '
 signature = 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
 }
 
Response = requests.get（url、params = params、headers = headers）

各レコードには、exec_price、exec_qty、side、fee、and order_idが含まれます。

貿易履歴のためにバイビットWebインターフェイスを使用します

APIを使用しないことを好むユーザーには、BYBITがWebベースのインターフェイスを提供して、個人の契約貿易履歴を表示します。 bybitアカウントにログインして、次のように移動します。

• デリバティブ→注文→貿易履歴

ここで、あなたは：

• 線形契約または逆契約を選択します
• ドロップダウンから特定のシンボルを選択します
• 日付範囲ごとにフィルター
• CSV形式で一度に最大100レコードをエクスポートする

表示されている列には、シンボル、サイド、数量、価格、料金、閉じたPNL、および時間が含まれます。 Webインターフェイスでは、ワンクリックですべての履歴データのバルクエクスポートが許可されていないことに注意してください。必要に応じて、日付を手動でページングし、複数のCSVファイルをダウンロードする必要があります。

履歴データの処理と保存

取得したら、分析のために履歴貿易データを保存する必要があります。推奨される形式には、CSV、Parquet、またはデータベーステーブルが含まれます。継続的なデータ収集については、定期的にAPIを呼び出して新しいレコードを追加するCronジョブまたはスクリプトを設定します。

重要な考慮事項：

• レート制限：BYBITでは、パブリックエンドポイントで1分あたり60のリクエストを許可し、プライベートで120を許可します
• データの重複排除： exec_idまたはtrade_timeを一意の識別子として使用する
• タイムゾーン処理：すべてのタイムスタンプはUTCにあります
• データ保持：BYBITはWebインターフェイスで最大6か月間個人貿易履歴を保持しますが、APIアクセスにより、アカウントアクティビティに応じて古いデータの取得が可能になる場合があります

構造化されたディレクトリにデータを保存します：

 /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の内部保持ポリシーに応じて、数か月前に戻ることができます。

バックテストのためのティックレベルの履歴データを取得できますか？

はい、 /v5/market/recent-tradeエンドポイントは、取引あたりの価格と量を含むティックレベルのデータを提供します。完全なティック履歴を構築するには、APIを継続的に投票するか、WebSocket Streams（ publicTradeトピック）を使用してリアルタイムの取引をキャプチャして保存する必要があります。

プライベートデータにアクセスするときに「無効な署名」エラーが発生するのはなぜですか？

このエラーは、HMAC署名が一致しないときに発生します。パラメーター文字列がアルファベット順に正しくソートされていることを確認し、タイムスタンプはミリ秒単位で、APIシークレットが正しく入力されます。また、HTTPメソッド（GET/POST）がエンドポイントの予想形式と一致することを確認します。

期限切れの先物契約で履歴データが利用可能ですか？

はい、期限切れの先物契約の履歴貿易データは、契約のアクティブ期間中に使用される正しいシンボル名を指定することにより、APIを介してアクセスできます。たとえば、2023年12月BTC逆先物のBTCUSD231229 。同じAPIエンドポイントが適用され、 category=inverseと適切なシンボルがあります。