Bybit APIの使用方法は？

BYBIT APIは、安全な休憩とWebSocketのエンドポイントを介して、自動化された取引、リアルタイムデータストリーミング、および位置管理を可能にします。

2025/08/04 23:42

バイビットAPIとそのユースケースを理解します

BYBIT APIは、トレーダーと開発者がBYBITの取引プラットフォームとプログラムで対話できるようにする強力なインターフェイスです。これにより、取引戦略の自動化、リアルタイム市場データの検索、注文配置、ポジション管理、およびアカウント残高の監視を可能にします。 APIは、 RestfulとWebsocketプロトコルの両方をサポートし、異なるユースケースに柔軟性を提供します。 REST APIは、注文またはチェックバランスの配置などの1回限りのリクエストに最適ですが、WebSocketは、ライブ価格の更新や注文書変更などの継続的なデータストリーミングに最適です。 APIを使用する前に、ユーザーはBYBitアカウントからAPIキーを生成する必要があります。これは、認証資格情報として機能します。

Bybit APIキーを生成します

Bybit APIの使用を開始するには、最初にAPIキーを作成する必要があります。このプロセスは、Bybitアカウントダッシュボード内で直接行われます。プロファイル設定の下のAPI管理セクションに移動します。 [APIの作成]をクリックします。ここでは、APIキーの名前を入力してIP制限を設定するように求められます。 IPホワイトリストは、指定されたIPアドレスへのAPIアクセスを制限することにより、セキュリティを強化します。必要な詳細を入力した後、BybitはAPIキーとシークレットキーのペアの資格情報を生成します。秘密の鍵は最初の作成後に再び表示されないため、これらは安全に保管する必要があります。これらのキーを共有したり、クライアント側のコードで公開したりしないでください。

リクエストのAPI認証の構成

Bybit APIのすべてのプライベートエンドポイントには、APIキーとシークレットキーを使用して認証が必要です。認証は、 HMAC SHA256署名を介して実装されます。各リクエストには、特定のヘッダーを含める必要があります。

• X-Bapi-Api-Key ：APIキー
• X-Bapi-Sign ：生成された署名
• X-Bapi-Timestamp ：ミリ秒単位の現在のタイムスタンプ
• X-Bapi-Recv-Window ：オプションは、リクエストの有効性の時間ウィンドウを定義します（デフォルトは5000msです）

X-Bapi-Signを生成するには、特定の順序（Timestamp + API_Key + Recv_Window + Query_String）で要求パラメーターを連結し、HMAC SHA256を使用してシークレットキーを使用してハッシュします。ほとんどのプログラミング言語は、これに組み込みライブラリを提供します。たとえば、Pythonでは、 hmacおよびhashlibモジュールを使用します。署名エラーを回避するために、タイムスタンプがBybitのサーバー時間と同期されていることを確認してください。

REST APIを使用して注文を配置します

BYBIT APIを介して取引を行うには、 /v5/order/createなどの適切なエンドポイントにPOSTリクエストを送信します。必要なパラメーターは次のとおりです。

• シンボル：トレーディングペア、例えば、 btcusdt
• サイド：売買
• OrderType ：制限、市場、停止など
• 数量：取引数量
• 価格：制限注文に必要です
• TimeInforce ：実行手順を指定します。たとえば、 GTC （キャンセルまで良い）

リクエストを送信する前に、すべてのパラメーターが正しくフォーマットされ、署名計算に含まれていることを確認してください。応答が成功すると、 OrderID 、 OrderLinkID 、およびステータスを含むJSONオブジェクトが返されます。実行を確認するために、応答コードとメッセージを常に検証してください。 OrderLinkidを使用して、後続のクエリで注文を追跡します。

WebSocketを使用したリアルタイムデータのストリーミング

アルゴリズムトレーディングボットや市場監視ダッシュボードなど、ライブアップデートを必要とするアプリケーションの場合、BybitのWebSocketAPIが不可欠です。 usdt永久契約のために、wssocketエンドポイント： wss://stream.bybit.com/v5/public/linearに接続します。接続を確立した後、購読メッセージ形式を使用してトピックを購読します。例は次のとおりです。

• Orderbookl2_25.btcusdt ：トップ25注文書レベル
• Tickers.btcusdt ：リアルタイムティッカーデータ
• candle.1.btcusdt ：1分間のcandlestickデータ
• publicTrade.btcusdt ：最近の取引

受信した各メッセージには、トピックフィールドとデータペイロードが含まれます。それに応じてJSON応答を解析します。ポジションやバランスの更新などのプライベートデータの場合、プライベートエンドポイントへの個別のWebSocket接続を確立し、RESTに似た認証ヘッダーを含めます。

APIを介してポジションとリスクの管理

バイビットAPIにより、オープン位置を完全に制御できます。現在の位置を取得するには、 /v5/position/listにget requestを送信します。応答には、サイズ、エントリプライス、未実現のPNL 、およびレバレッジが含まれます。ストップロスの調整や営利レベルの調整などの位置を変更するには、 /v5/position/trading-stopエンドポイントを使用します。必要なパラメーター：

• シンボル
• ストップロス：停止価格
• TakeProfit ：営利の価格

これらの値が許容価格の範囲内とアカウントレバレッジ設定内にあることを確認してください。ポジションを閉じるために、同じ数量で対立する市場順序を置きます。たとえば、1 btcの購入ポジションを保持している場合は、1 btcの販売市場注文を送信します。次の位置クエリで更新された位置サイズをチェックして閉鎖を確認します。

よくある質問

BYBIT API Secretキーをリセットするにはどうすればよいですか？

バイビットでは、シークレットキーを直接リセットすることはできません。既存のAPIキーを削除し、新しいキーを作成する必要があります。 API管理に移動し、キーを見つけ、 [削除]をクリックし、アクションを確認し、新しいキーペアを生成します。新しい資格情報でアプリケーションをすぐに更新します。

IP制限なしでBybit APIを使用できますか？

はい、しかしそれは非常に落胆しています。 IP制限を無効にすると、APIキーが潜在的な誤用にさらされます。無効にする必要がある場合は、アプリケーションが暗号化されたストレージや最小限の許可スコープなどの追加のセキュリティレイヤーを使用していることを確認してください。

バイビットAPIにはどのレート制限が適用されますか？

バイビットは、虐待を防ぐためにレート制限を実施します。 REST APIでは、IPごとに最大60秒のリクエストが許可されます。 WebSocket接続は、接続ごとに最大24のサブスクリプションをサポートしています。制限を超えると、429エラーが発生します。複数のIPでリクエストを配布するか、可能な場合はバッチを使用します。

なぜ「無効な署名」エラーが発生しているのですか？

これは通常、パラメーターの順序が誤っていないために発生します。タイムスタンプがX-Bapi-Timestampヘッダーと一致し、パラメーターが辞書編成的にソートされ、HMAC SHA256が正しいシークレットキーで使用されることを確認します。 /v5/user/query-apiなどの単純なエンドポイントでテストして、問題を分離します。