契約取引にBybit APIを使用する方法は？

BYBIT APIは、安全な認証、WebSocketを介したリアルタイムデータ、およびUSDTおよび逆契約のフルオーダー管理を備えた自動契約取引を可能にします。

2025/08/11 13:01

契約取引のためのバイビットAPIを理解する

Bybit APIは、トレーダーがバイビット交換で契約取引戦略を自動化できる強力なツールです。 APIを活用することにより、ユーザーはプログラム的に注文を配置し、ポジションを管理し、市場データを取得し、アカウントのステータスを監視できます。まず、BYBITがリアルタイムインタラクションのためにRESTFUL APIとWebSocketAPIをサポートしていることを理解することが不可欠です。契約取引のAPIエンドポイントは、USDT永久、逆永遠、および先物契約に合わせて特別に調整されています。統合の前に、取引する契約タイプに基づいて正しいAPIドキュメントにアクセスしていることを確認してください。

開始するには、Bybitアカウント設定に移動し、APIキーを生成します。このプロセス中に、「注文」、「資産」、「読み取り専用」などのアクセス許可を定義する必要があります。契約取引には、「注文」と「位置」の両方の権限が必要です。クライアント側のコードやパブリックリポジトリに秘密の鍵を公開しないでください。安全な通信を確保するために、API呼び出しを行うときは常にHTTPSを使用してください。

API資格情報を設定します

Bybit APIを効果的に使用するには、最初にAPIキーを作成および構成する必要があります。 Bybitアカウントにログインし、プロフィールの下のAPI管理セクションに移動します。 [APIの作成]をクリックし、[キーに名前を割り当てて簡単に識別します。許可を設定するとき：

• 貿易許可を有効にして、注文の配置とキャンセルを許可します
• オープンポジションにアクセスし、設定を活用できる位置の許可を有効にします
• セキュリティリスクを減らすために絶対に必要な場合を除き、撤退を制限します

作成後、 APIキー、シークレットキー、ユーザーIDの3つの重要なコンポーネントが届きます。これらをしっかりと保管してください。また、 IP制限を設定して、特定のIPアドレスへのAPIアクセスを制限し、セキュリティを強化することもできます。 IPが変更された場合は、それに応じてホワイトリストを更新する必要があります。 Bybitは認証にHMAC-Sha256を使用しているため、リクエストには適切に署名されたメッセージが含まれている必要があることに注意してください。

APIリクエストの認証

BybitへのすべてのプライベートAPI要求は、 APIキーとシークレットキーを使用して認証する必要があります。認証プロセスには、HMAC-SHA256ハッシュを使用して署名を生成することが含まれます。署名される文字列には通常、HTTPメソッド、要求パス、クエリパラメーター、およびタイムスタンプが含まれます。タイムスタンプは、リプレイ攻撃を防ぐために、サーバー時間の5秒以内でなければなりません。

署名の構築方法は次のとおりです。

• 要求方法（例：投稿）、リクエストパス（/v5/注文/作成）、およびクエリ文字列（存在する場合）を連結します
• hmac-sha256を使用して連結した文字列をハッシュするために秘密の鍵を使用してください
• 結果を16進形式でエンコードします
• X-BAPI-SIGNとしてリクエストヘッダーに署名を含めます

必要な追加のヘッダーにはX-BAPI-API-KEY 、 X-BAPI-TIMESTAMP 、 X-BAPI-RECV-WINDOW （オプション、デフォルト5000ms）が含まれます。誤ったタイムスタンプまたは署名は、認証障害になります。システムのクロックがNTPサーバーと同期されていることを常に確認してください。

契約注文の配置と管理

Bybit APIを介して契約注文を配置するには、 /v5/Order/Create Endpointを使用します。シンボル、サイド（購入または販売）、オーダータイプ（制限、市場など）、数量、価格（制限注文の場合）などの必須パラメーターを含める必要があります。 USDTマルン化契約の場合、シンボル形式はBTCUSDTです。逆契約の場合、それはBTCUSDです。

考慮すべき重要なパラメーター：

• TimeInforce ：オプションには、goodtillcancel、fillorkill、fillorkillが含まれます
• Reduceonly ：順序が位置サイズのみを削減するようにtrueに設定します
• CloseOntrigger ：ストップロスまたは営利の注文に役立ちます
• positionIdx ：ヘッジモードに必要です。片道で0、長い間は1、略して2

注文をキャンセルするには、 /v5/注文/キャンセルエンドポイントをOrderIDまたはOrderLinkIDで使用します。アクティブな注文を取得するには、 /V5/Order/RealTimeを使用します。ポジション管理の場合、 /v5/position/listエンドポイントは、サイズ、エントリー価格、レバレッジなどの現在の位置を返します。 /v5/position/set-leaveraを使用してレバレッジを調整します。

市場とアカウントデータの取得

リアルタイムの市場データは、情報に基づいた取引決定に重要です。 Bybitは、この目的のためにいくつかのパブリックエンドポイントを提供します。 /v5/market/ティッカーを使用して、すべての契約で最新の価格、資金調達率、24時間の量を取得します。注文帳データの場合、シンボルパラメーターと深さパラメーターを使用して/V5/Market/Orderbookを使用します（例、1、5、50レベル）。履歴のろうそく足データを取得するには、カテゴリ、シンボル、間隔、および開始/終了時間を使用して/V5/Market/Klineを使用します。

アカウント関連のデータの場合、 /v5/アカウント/ウォレットバランスエンドポイントは、すべてのコインでウォレットバランスを返します。 /V5/アカウント/情報を使用して、総株式と利用可能な残高を含む全体的なアカウントの詳細を取得します。最近の注文充填を監視するには、 /v5/order/execution-listを使用します。これにより、実行された取引は価格、数量、料金、およびexectimeで返品されます。

リアルタイムアップデートのためにWebSocketを実装します

低遅延取引の場合、RESTエンドポイントを投票する代わりに、BYBitのWebSocketAPIを使用します。 wss://stream.bybit.com/v5/public/linear for usdt契約またはwss://stream.bybit.com/v5/public/inverseに接続します。リアルタイムデータを購読するには、 OPフィールドを「サブスクライブ」に設定したJSONメッセージを送信し、 orderBookL2_25.BTCUSDT 、 tickers.BTCUSDT 、またはcandle.1.BTCUSDTなどのトピックを含むArgsアレイを送信します。

注文の更新や位置変更などのプライベートデータの場合、WebSocket接続を認証します。 APIキー、タイムスタンプ、および署名で認証リクエストを送信します。認証されたら、 order 、 position 、およびexecutionトピックを購読して、ライブアップデートを受け取ります。 WebSocketメッセージはZLIBを使用して圧縮されるため、解析する前にそれらを圧縮します。

よくある質問

Bybit APIのレート制限はいくらですか？

バイビットは、虐待を防ぐためにレート制限を実施します。 REST APIの場合、制限は通常、APIキーごとに60秒あたり60リクエストです。これを超えると、HTTP 429エラーが発生します。 WebSocket接続により、スループットが高くなりますが、サブスクリプションカウントとメッセージ頻度に基づいて制限の対象となります。

「無効な署名」などのAPIエラーを処理するにはどうすればよいですか？

秘密の鍵が正しく、トリミングされていないことを確認してください。署名文字列に正確な方法、パス、およびパラメーターが含まれていることを確認します。タイムスタンプがMillisecondsで、Bybitのサーバー時間から5秒以内にあることを確認してください。 https://api.bybit.com/v5/market/timeを使用して、現在のサーバー時間を取得します。

グリッドトレーディングまたはDCAボットにBybit APIを使用できますか？

はい、APIは自動化された戦略をサポートしています。 /v5/注文/作成/作成価格と数量でループを作成します。ロジックを実装して、古い注文をキャンセルし、市場の状況に基づいて位置を調整します。ボットは、資金調達率の支払いと清算リスクを処理してください。

TestNetはAPI契約取引に利用できますか？

はい、Bybitはhttps://api-testnet.bybit.comでテストネット環境を提供しています。それを使用して、実際の資金を危険にさらすことなく取引をシミュレートします。テストネット用の個別のAPIキーを生成します。すべてのエンドポイントはライブ環境を反映しており、完全な戦略テストを可能にします。