Bybit で API キーの権限を確認する方法

API キーの権限レベルについて

1. Bybit は、API 権限を読み取り専用、取引、引き出しの 3 つの異なる階層に分類します。

2. 読み取り専用アクセスにより、状態を変更せずに市場データ、口座残高、注文履歴、ポジション情報を取得できます。

3. 取引許可により、スポット市場、マージン市場、デリバティブ市場全体で注文の発注、キャンセル、および変更が可能になります。

4. 出金許可により、Bybit アカウントから資金移動を開始できるようになります。この権限には、明示的な手動アクティベーションと追加のセキュリティ検証が必要です。

5. 各権限レベルは API キーの作成時に割り当てられ、新しいキー ペアを生成しない限り遡って変更することはできません。

API キー ダッシュボードを見つける

1. 検証済みの資格情報を使用して Bybit アカウントにログインし、2FA 認証を完了します。

2. 右上のユーザー メニューに移動し、[セキュリティ センター] セクションの [API 管理] を選択します。

3. ダッシュボードには、すべてのアクティブな API キーと、それらに関連付けられたラベル、作成タイムスタンプ、および IP バインディング ステータスが表示されます。

4. キーの横にある「詳細」ボタンをクリックすると、許可フラグやホワイトリストに登録された IP を含む完全な設定が表示されます。

5. 「テストネットのみ」とマークされたキーは個別に表示され、設計によりメインネットの操作から分離されています。

API 応答による許可フラグの検証

1. API キーとシークレット署名を使用して、GET リクエストを/user/infoエンドポイントに送信します。

2. 必要なヘッダー: X-BAPI-API-KEY 、 X-BAPI-SIGN 、 X-BAPI-TIMESTAMP 、およびX-BAPI-RECV-WINDOW を含めます。

3. 成功した応答は、有効な機能をブール値としてリストした権限フィールドを含む JSON オブジェクトを返します。

4. 応答に'withdraw': true が含まれる場合、キーには取り消し権限があります。明示的に要求されない限り、この値は false のままにする必要があります。

5. 権限インジケーターが欠落しているか一貫性がない場合は、構成ミスまたはキーの初期化が不完全であることを示唆しています。

実際の権限制限の解釈

1. 読み取り権限のみを持つ API キーは、 /order/createに POST しようとすると HTTP 403 を返します。

2. 出金以外のキーを使用して/asset/withdraw を呼び出そうとすると、エラー コード10004と「出金の許可がありません」という説明メッセージが表示されます。

3. 取引エンドポイントは厳密な検証を強制します。デリバティブ権限がないキーに対してレバレッジ パラメーターを指定して注文を送信すると、エラー11001が発生します。

4. 許可範囲に基づいてレート制限動作が変更される - 取引キーは、読み取り専用キーよりも厳しい重みベースの割り当てに直面します。

5. リクエストが登録されたアドレス範囲外から発信された場合、許可レベルに関係なく、IP バインドされたキーはサイレントに失敗します。

よくある質問

Q: API キーの作成後に権限をダウングレードできますか?いいえ。Bybit は既存のキーの権限の変更をサポートしていません。現在のキーを非アクティブ化し、必要な設定で新しいキーを生成する必要があります。

Q: セットアップ中に API キーを選択したにもかかわらず、「Trading: false」と表示されるのはなぜですか?これは、アカウント設定で先物取引またはデリバティブ取引を有効にする前にキーが作成された場合に発生します。まずこれらのモジュールを有効にしてから、キーを再生成します。

Q: 私のキーがどのエンドポイントに正常にアクセスしたかを監査する方法はありますか?はい。 Bybit は、認証されたすべての API 呼び出しを API Management インターフェイス内の [API アクティビティ履歴] タブに記録し、タイムスタンプ、エンドポイント、および応答コードを表示します。

Q: API キーを IP アドレスにバインドし、後でネットワークを変更するとどうなりますか?リストにない IP からのリクエストは、エラー コード10002の HTTP 401 を受け取ります。機能を復元するには、IP ホワイトリストを更新するか、バインドを無効にする必要があります。