Bybit で API 取引を使用するにはどうすればよいですか?開発者初心者ガイド

API アクセスとキー管理

1. 公式 Web サイトまたはデスクトップ アプリケーションから Bybit アカウントにログインします。

2. [アカウント設定] → [API 管理] → [API キーの作成] に移動します。

3. わかりやすい名前を割り当て、IP ホワイトリスト制限を選択し、「読み取り専用」、「取引」、「引き出し」などの必要な権限のみを有効にします。

4. 2FA を使用して作成を確認します。 API キーと API シークレットの両方を暗号化されたボールトにオフラインで保存します。

5. フロントエンド コード、ブラウザ コンソール、またはパブリック リポジトリで API シークレットを決して公開しないでください。

サポートされている API バージョンとエンドポイント

1. Bybit V5 REST API は、統一された構造と一貫した応答スキーマを備えたスポット、デリバティブ、およびアセットのエンドポイントを提供します。

2. WebSocket パブリック チャネルは、注文帳深さ (orderbook.50)、ティッカー (ticker)、取引執行 (publicTrade) を含むリアルタイムの市場データを配信します。

3. WebSocket プライベート チャネルは、ポジションの更新、注文ステータスの変更、ウォレット残高通知、実行レポートをサポートします。

4. 統合取引口座エンドポイントにより、手動資金移動なしでスポットとデリバティブにわたるクロスマージン操作が可能になります。

5. すべてのエンドポイントは厳密なタイムスタンプ同期を必要とします。クロック スキューが 30 秒を超えると拒否が引き起こされます。

認証ワークフロー

1. 各リクエストには、アクティブな API キーを含む X-BAPI-API-KEY ヘッダーが含まれている必要があります。

2. X-BAPI-SIGN ヘッダーには、連結された文字列の HMAC SHA256 ハッシュが含まれます: timestamp + api_key + recv_window + payload 。

3. X-BAPI-TIMESTAMP ヘッダーには、ミリ秒単位の現在の Unix タイムスタンプが含まれます。

4. X-BAPI-RECV-WINDOW は、署名検証の許容可能な時間枠を定義し、デフォルトは 5000 ミリ秒です。

5. ペイロードは、署名前に空白なしで JSON シリアル化し、キーを辞書順に並べ替える必要があります。

レート制限とエラー処理

1. REST API は、パブリック エンドポイントの場合は API キーごとに 1 分あたり 120 のリクエスト、プライベート エンドポイントの場合は 1 分あたり 60 のリクエストを強制します。

2. WebSocket 接続は、接続ごとに 100 サブスクリプションに制限されます。超過すると自動的に切断されます。

3. HTTP 429 応答はレート制限の枯渇を示します。クライアントは指数バックオフとジッターを実装する必要があります。

4. 一般的なエラー コードには、10001 (無効な署名)、10002 (期限切れのタイムスタンプ)、および 30087 (不十分なマージン) があります。

5. すべてのエラー本文には、retCode、retMsg、および orderId やデバッグ用のシンボルなどの追加のコンテキスト フィールドが含まれます。

よくある質問

Q: テストネットとメインネットの両方に同じ API キーを使用できますか?いいえ。テストネットとメインネットには、それぞれのドメインから生成された個別の API キーが必要です。 https://api-testnet.bybit.com で発行されたキーは実稼働環境では無効です。

Q: Bybit は注文約定のための Webhook 統合をサポートしていますか?いいえ、Bybit は Webhook 配信を提供しません。クライアントは、永続的な WebSocket 接続を維持するか、REST エンドポイントをポーリングして入力確認を行う必要があります。

Q: API キーをプログラムで取り消すことは可能ですか?はい。有効な認証を使用して DELETE /v5/user/api-key エンドポイントを使用します。この操作にはターゲット キーの ID が必要であり、元に戻すことはできません。

Q: Bybit によって公式に保守されている Python または JavaScript 用の SDK はありますか? Bybit は、コミュニティでサポートされている SDK を GitHub で提供していますが、公式に管理されている言語固有のライブラリを公開または推奨していません。開発者は、サードパーティが管理する pybit および bybit-api パッケージに依存しています。