Bybit 取引ボットの構築方法: 開発者向けテクニカル ガイド

Bybit API アーキテクチャの概要

1. Bybit の REST および WebSocket API は、各エンドポイントが特定の重み層に属する厳密なレート制限フレームワークで動作します。ティッカーやオーダーブック クエリなどのパブリック エンドポイントは呼び出しごとに 1 ユニットを消費しますが、注文や位置変更などのプライベート エンドポイントは、ペイロードの複雑さに応じて 3 ～ 10 ユニットの範囲の重みを持ちます。

2. 認証は、秘密キー、タイムスタンプ、正規化されたリクエスト文字列を使用して生成された HMAC-SHA256 署名に依存します。 nonce アライメントまたは署名の有効期限ウィンドウ (最大 30 秒) に不一致があると、即座に 401 Unauthorized 応答がトリガーされます。

3. v5 API では、スポット市場、インバース永久市場、リニア永久市場、およびオプション市場にわたる統合マージン モードのサポートが導入されています。これには、あいまいなルーティング エラーを回避するために、すべてのリクエスト ヘッダーでカテゴリ パラメーターを明示的に指定する必要があります。

4. プライベート チャネルにサブスクライブする前に、必須の認証ハンドシェイクを使用して WebSocket 接続を確立する必要があります。接続後 10 秒以内に認証パケットを送信できない場合は、強制終了します。

5. 作成、部分約定、全約定、キャンセル、拒否などの注文ライフサイクル イベントは、注文、約定、ポジションなどの個別のトピックの下で個別のストリームを介して発行されるため、トピックごとに独立したサブスクリプション管理が必要です。

コア統合コンポーネント

1. ccxt.bybitコネクタは、X-RateLimit-Remaining ヘッダーを解析し、しきい値が割り当てられたクォータの 20% を下回った場合に後続のリクエストを動的に調整することで、自動レート制限適応を処理します。

2. マージン モード切り替えロジックは、 exchange_instance_service.tsモジュールに常駐し、生の API 呼び出しをエンド ユーザーに公開することなく、分離構成とマージン間構成間のアトミックな状態遷移を強制します。

3. オーダーブック深さのスナップショットは、 orderBookL2_25 WebSocket ストリームを通じて取得され、各更新ペイロードに埋め込まれたマイクロ秒レベルの精度のタイムスタンプを使用して、価格によってソートされた買値/売値レベルを提供します。

4. 位置の同期では、デルタベースの調整が使用されます。ボットは、すべての位置更新イベントで返されるサーバー側の位置バージョン番号とローカル キャッシュ チェックサムを比較し、完全な状態をリロードすることなく不一致を検出して解決します。

5. 取引実行の検証は、送信前のパラメーターのサニタイズ、応答後のステータス コードの検証、実行ストリームの相関関係による約定後の確認の 3 つのレイヤーで行われ、未確認の注文があいまいな状態で残らないようにします。

戦略実行メカニズム

1. Bybit の線形永久契約に基づいて構築されたトレンドフォロー戦略は、 GET /v5/market/candles経由で取得したローソク足データから直接 EMA(9) および EMA(21) の値を計算し、間隔解像度は 1 分まで構成可能です。

2. ストップロスとテイクプロフィットのレベルは、部分に設定されたtpSlModeパラメーターを使用してエントリー注文と一緒にアトミックに送信され、リアルタイムの ATR(14) 計算に基づいてトレーリング ストップを動的に調整できます。

3. 資金調達レート裁定取引ロジックは、複数のシンボルにわたるGET /v5/market/funding/historyエンドポイントを同時に監視し、絶対資金調達差が 3 つの連続した間隔で 0.025% を超えた場合にのみヘッジ ポジションをトリガーします。

4. 清算リスク評価では、 walletBalanceストリームからのリアルタイムの口座資本更新とオープンポジションの想定元本を統合し、200 ミリ秒ごとに証拠金率を計算します。

5. 時間加重平均価格 (TWAP) 実行では、大きな注文が設定可能な間隔で配置された固定サイズの子注文に分割されます。各子注文の価格は、現在の仲値と最後の 5 秒の注文帳深度から計算されたスリッページ バッファーから導出されます。

エラー処理と回復プロトコル

1. ネットワーク切断の検出では、デュアルレイヤー監視を使用します。OS レベルでの TCP キープアライブ タイムアウトと、すべてのアクティブな WebSocket 接続でのアプリケーション レベルの ping/pong ハートビート検証を 15 秒ごとに組み合わせます。

2. 注文の送信に失敗すると、5 回の試行を上限とする指数バックオフ再試行シーケンスがトリガーされ、分散ボット インスタンス間での再試行の同期を防ぐためにジッターが適用されます。

3. 無効な署名エラーにより即時再認証フローが開始され、60 秒以内に失敗が 3 回を超えた場合、キャッシュされた認証情報が破棄され、新しい API キーの再生成が強制されます。

4. オーダーブックの非同期は、REST GET /v5/market/orderbookを介して完全なスナップショットをリクエストし、その後の WebSocket 更新による増分デルタ パッチを適用することで修正されます。

5. ポジション不一致の回復は、分離マージン口座の場合はPOST /v5/position/reset-isolate を介して、クロスマージン シナリオの場合はPOST /v5/position/set-leverageを通じて強制ポジション リセットを呼び出し、一貫した状態の調整を復元します。

セキュリティ構成標準

1. API キーの権限は取引所レベルで適用されます。取引キーでは注文管理とポジション管理が有効になっている必要がありますが、読み取り専用キーでは口座情報へのアクセスのみが必要です。

2. IP ホワイトリスト登録は、運用環境の導入には必須です。事前に承認された CIDR 範囲外から発信されたリクエストは、有効な署名に関係なく、即座に 403 Forbidden 応答を受け取ります。

3. 秘密キーは、プロセスごとの一時キーを 24 時間ごとにローテーションする AES-256-GCM を使用して暗号化されて保存されるため、メモリ ダンプが侵害された場合でも長期にわたる漏洩を防ぎます。

4. すべてのアウトバウンド HTTP リクエストには、5000 ミリ秒に設定されたX-BAPI-RECV-WINDOWヘッダーが含まれており、リプレイ攻撃ベクトルを軽減するために、このしきい値を超えて遅延したサーバー応答を拒否します。

5. 2 要素認証バイパス トークンはローカルに保持されることはありません。トークンは、初期セットアップ中にオンデマンドで生成され、API 登録が成功した直後に破棄されます。

よくある質問

Q1: Bybit でのスポット取引とデリバティブ取引の両方に同じ API キーを使用できますか?はい。ただし、キーの作成時に両方のカテゴリに対するアクセス許可を明示的に付与する必要があります。スポットのみのキーを使用してデリバティブ エンドポイントにアクセスしようとすると、エラー コード 10003 が返されます。

Q2: Bybit は、異なる取引ペア間で重複する注文 ID をどのように処理しますか?各注文 ID はそのシンボルにスコープされます。同一のクライアント注文 ID が競合することなく BTCUSDT と ETHUSDT に同時に存在する可能性がありますが、衝突検出は同じ取引ペアのコンテキスト内で厳密に適用されます。

Q3: 私のボットが無効なレバレッジ設定で注文を送信した場合はどうなりますか? API はエラー コード 30083 でこれを拒否し、応答本文に正確な許容レバレッジ範囲を含めることで、手動介入なしで即時に修正できるようになります。

Q4: 大量の注文を行う前に、現在の市場の流動性をプログラムで判断する方法はありますか?はい - GET /v5/market/tickersエンドポイントは、帳簿上の流動性ボリュームを示す bidSize フィールドと askSize フィールドを返しますが、 GET /v5/market/orderbook は指定された価格レベルでの累積深度を提供します。