BYBitでAPIトランザクションレコードを表示する方法は？トランザクションの数に制限はありますか？

BYBITのAPIを使用すると、ユーザーは/V2/プライベート/ウォレット/トランザクションログエンドポイントを使用してトランザクションレコードを取得し、レートおよび履歴データアクセスに制限されます。

2025/05/19 07:07

Bybitは、取引戦略を自動化したり、プログラムでポートフォリオを管理したりしたいトレーダーに堅牢なAPIサービスを提供する人気のある暗号通貨交換です。ユーザーがAPIを介してアクセスする必要がある重要な機能の1つは、トランザクションレコードです。この記事では、BYBitでAPIトランザクションレコードを表示するプロセスをガイドし、取得できるトランザクションの数に導入される可能性のある制限について説明します。

BybitのAPIの理解

トランザクションレコードを取得する詳細に飛び込む前に、BybitのAPIの基本を理解することが不可欠です。 BybitのAPIを使用すると、ユーザーはプログラムでプラットフォームと対話できます。これには、取引の実行、注文の管理、トランザクションレコードなどのさまざまなデータの取得が含まれます。 APIは、安全で効率的であるように設計されており、ユーザーがアカウントを効果的に管理できるようにします。

APIへのアクセス

BybitのAPIの使用を開始するには、APIキーを設定する必要があります。ここにそうするための手順があります：

• バイビットアカウントにログインします。
• API管理セクションに移動します。これは通常、アカウント設定またはユーザープロファイルセクションの下にあります。
• 新しいAPIキーを作成します。ニーズに応じて、キーおよび設定アクセス許可の名前を提供する必要があります。
• APIキーと秘密を保存します。これらは、APIリクエストを認証するために使用されます。

取引記録の取得

APIキーを設定したら、トランザクションレコードを取得するリクエストを開始できます。 BYBITのAPIは、トランザクションデータを取得するために特別に設計されたエンドポイントを提供します。使用するエンドポイントは/v2/private/wallet/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'
 endpoint = '/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
 }
 
リクエストを送信します
Response = requests.get（base_url + endpoint、headers、params = params）
 
応答を処理します
response.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' } ]
 }
 }

トランザクションレコードの制限

Bibitは、APIを介して取得できるトランザクションの数に特定の制限を課します。これらの制限は、虐待を防ぎ、プラットフォームのリソースの公正な使用を確保するために整っています。留意すべき重要なポイントは次のとおりです。

• レート制限：BYBITには、API要求にレート制限があります。たとえば、1分あたりの特定のリクエストまたは1日あたりのリクエストに限定される場合があります。これらの制限を超えると、APIキーが一時的にブロックされる可能性があります。
• ページネーション：トランザクションレコードを取得するとき、BYBITはページネーションを使用して大規模なデータセットを管理します。各応答で返されるレコードの数を制御するためにlimitパラメーターを指定し、 pageパラメーターを使用して複数のページの結果をナビゲートできます。
• 履歴データ：トランザクションレコードをどの程度戻ることができるかに制限があるかもしれません。 BYBITでは、通常、過去の一定の日または数ヶ月間、データを取得できます。

これらの制限を効果的に管理するには、次のようにする必要があります。

• API使用量を監視します。リクエストの数を追跡し、レート制限内にとどまることを確認してください。
• ページネーションを実装します。 limitパラメーターとpageパラメーターを使用して、管理可能なチャンクのデータを取得します。
• データ検索を計画します。大量の履歴データを取得する必要がある場合は、制限に衝突しないようにリクエストを慎重に計画してください。

取り扱いエラー

BybitのAPIを使用すると、エラーが発生する可能性があります。一般的なエラーには、認証障害、レート制限が超えた、および無効なパラメーターが含まれます。これらのエラーを処理する方法は次のとおりです。

• 認証エラー：認証エラーを受け取った場合は、APIキーと秘密を再確認してください。リクエストヘッダーに正しく含まれていることを確認してください。
• レート制限エラー：レート制限を超えた場合は、リクエストを再試行する前に期間を待ちます。レートの制限のヒットを繰り返し防止するために、コードの遅延を実装します。
• 無効なパラメーター：APIが無効なパラメーターのためにエラーを返した場合、要求を確認し、すべてのパラメーターが正しくフォーマットされ、許容範囲内であることを確認します。

FAQ

Q：BybitのAPIを使用して、複数の通貨のトランザクションレコードを一度に取得できますか？

A：いいえ、BYBITのAPIでは、トランザクションレコードを取得するときに単一の通貨を指定する必要があります。複数の通貨のレコードが必要な場合は、各通貨に対して個別のAPI要求を行う必要があります。

Q：トランザクションレコードを取得するときにAPIキーのセキュリティを確保するにはどうすればよいですか？

A：APIキーのセキュリティを確保するには、誰とも共有しないでください。安全な環境でのみ使用します。さらに、BybitのIPホワイトリスト機能を使用して、特定のIPアドレスへのAPIアクセスを制限することを検討してください。

Q：スケジュールでトランザクションレコードの検索を自動化する方法はありますか？

A：はい、スケジュールでAPIリクエストを作成するスクリプトを作成することにより、トランザクションレコードの取得を自動化できます。 UNIXベースのシステム上のCron JobsやWindowsのタスクスケジューラなどのスケジューリングツールを使用して、定期的にスクリプトを実行します。

Q：リクエストエラーが多すぎる429に遭遇した場合はどうすればよいですか？

A：429エラーが発生した場合、Bybitのレート制限を超えたことを意味します。リクエストを再試行する前に一定期間待って、レートの制限を繰り返しヒットするのを防ぐためにコードの遅延を実装することを検討してください。