Bybit API チュートリアル: 自動取引に接続して開始するにはどうすればよいですか?

Bybit API 認証について

1. Bybit では、ユーザーのアカウント ダッシュボードの [API 管理] セクションで生成された API キーが必要です。これらのキーは API キーと秘密キーで構成されており、どちらもリクエストに署名するために不可欠です。

2. 秘密キーは、クライアント側のコードまたはパブリック リポジトリに決して公開してはなりません。これは、ID を検証して改ざんを防止するために、リクエストごとに HMAC-SHA256 署名を生成するために使用されます。

3. ユーザーはキーの作成時に正確なアクセス許可 (「注文」、「ウォレット」、または「契約」アクセスなど) を割り当てる必要があり、運用環境で運用している場合は IP アドレスを制限する必要があります。

4. 時刻同期は必須です。エラー コード 10004 で拒否されたリクエストは、タイムスタンプの不一致を示します。システムは、Bybit のサーバー時間に対して 30 秒未満のクロック ドリフトを維持する必要があります。

5. すべてのエンドポイントには、公開キーを含む X-BAPI-API-KEY ヘッダーと、連結されたパラメーターとシークレットから派生した Base64 でエンコードされた署名を保持する X-BAPI-SIGN ヘッダーが必要です。

REST API統合のセットアップ

1. 開発者は通常、Python とリクエストライブラリを使用して、認証された GET/POST 呼び出しを構築します。典型的な例には、/v5/account/wallet-balance エンドポイント経由でウォレット残高を取得することが含まれます。

2. クエリパラメータは、署名文字列を構築するときにハッシュする前にアルファベット順にソートする必要があります。リプレイ攻撃を避けるために、ノンス値は連続するリクエストにわたって単調に増加する必要があります。

3. レート制限はエンドポイントごとに異なります。パブリック エンドポイントでは 1 分あたり最大 60 リクエストが許可されますが、プライベート エンドポイントでは Bybit の機関レベルでアップグレードしない限り、1 分あたり 120 リクエストに制限されます。

4. エラー処理では、適切なフォールバック ロジックをトリガーするために、10001 (無効な API キー)、10002 (無効な署名)、または 110001 (不十分なマージン) などのステータス コードの JSON 応答を解析する必要があります。

5. セッションの再利用によりパフォーマンスが向上します。urllib3 の PoolManager を介した永続的な接続により、高頻度の注文送信時の TCP ハンドシェイク オーバーヘッドが削減されます。

WebSocket リアルタイム データ ストリーミング

1. Bybit は、リアルタイムの市場データ、取引執行の更新、ポジションの変更のために WebSocket v5 をサポートしています。接続は、REST と同じ API キーと署名方法を使用する単一の認証フレームで開始されます。

2. orderbook.1.BTCUSDTやtrade.BTCUSDTなどのトピックをサブスクライブするには、op: 'subscribe' および args: ['topic.name'] を使用して JSON ペイロードを送信する必要があります。

3. 接続の安定性を維持するには、ハートビート ping を 20 秒ごとに送信する必要があります。タイムアウトウィンドウ内に応答しないと、強制切断と再接続のシーケンスがトリガーされます。

4. メッセージ圧縮はデフォルトでは無効になっていますが、帯域幅に依存する展開の場合、WebSocket ハンドシェイク中にメッセージごとのデフレート拡張ネゴシエーションを介して有効にできます。

5. オーダーブックのスナップショットは、最初に完全な深さのスナップショットとして到着し、その後にデルタ更新が続きます。クライアントは、状態の非同期や価格設定の誤りを避けるために、これらのデルタを正しく適用する必要があります。

基本的な自動取引ボットの構築

1. 最小限の動作ボットは、認証情報の初期化、価格フィード用の WebSocket 接続の確立、注文用の REST セッションのセットアップから始まります。

2. 戦略ロジック (移動平均クロスオーバーの検出など) は、WebSocket 取引ストリームから再構築された、または REST /v5/market/kline 経由で取得されたティックレベルの OHLCV データで実行されます。

3. 注文実行では POST /v5/order/create を使用し、サイド (買い/売り)、orderType (マーケット/指値)、および数量フィールドを厳密に検証します。無効な数量形式では、エラー 30089 が返されます。

4. リスク管理には、送信前の利用可能な証拠金の確認、オープン注文数の制限の確認、資本比率に基づく最大ポジション サイズの強制が含まれます。

5. ロギングでは、遅延のスパイクや予期しないフィルのデバッグを支援するために、生のリクエスト/応答のペイロード、タイムスタンプ、および実行遅延メトリクスをキャプチャする必要があります。

よくある質問

Q: テストネットとメインネットの両方に同じ API キーを使用できますか? A: いいえ。テストネットとメインネットでは個別の API キーの生成が必要です。一方の環境で作成されたキーは、もう一方の環境では機能しません。

Q: ボットが重複した注文 ID を送信した場合はどうなりますか? A: Bybit は、24 時間以内に重複する clOrdID 値をエラー コード 110012 で拒否し、偶発的な二重送信を防ぎます。

Q: 7 日より古い過去の取引履歴を取得する方法はありますか? A: REST /v5/execution/list は、過去 1 週間のレコードのみを返します。拡張アーカイブの場合、ユーザーはライブ操作中に自分のインフラストラクチャで取引ログを有効にする必要があります。

Q: スポット API と派生 API は同じ認証フローを共有しますか? A: はい。どちらも同一の HMAC-SHA256 署名ロジックとヘッダー構造を使用しますが、エンドポイント パスと必要なパラメータは製品タイプによって大きく異なります。