KuCoin APIキーを取得するにはどうすればよいですか? (開発者ツール)

KuCoin開発者ポータルへのアクセス

1. KuCoin の公式 Web サイトに移動し、確認済みのアカウント資格情報を使用してログインします。

2. 「開発者」セクションを見つけます。通常は、上部ナビゲーション バーの「リソース」または「サポート」ドロップダウン メニューの下にあります。

3. 「API Management」をクリックして、専用の API 構成ダッシュボードに入ります。

4. 続行する前に、アカウントで 2 要素認証 (2FA) が有効になっていることを確認します。KuCoin は、これを必須のセキュリティ前提条件として強制します。

5. 意図した統合目的に合わせて、ページに表示される API の使用条件、レート制限、権限の範囲を確認します。

新しいKuCoin APIキーの作成

1. API Management インターフェース内で、「API キーの作成」ボタンをクリックします。

2. キーにわかりやすい名前 (「TradingBot-Prod」や「Analytics-Readonly」など) を割り当てて、その機能と環境を区別します。

3. 操作上のニーズに基づいて、「情報の読み取り」、「取引」、「出金」、または「証拠金」の正確な権限チェックボックスを選択します。 「引き出し」を有効にすると、必須の電子メール確認とアクティブ化前の 24 時間のクールダウンがトリガーされます。

4. カンマ区切りの IPv4 アドレスを入力して、IP ホワイトリストを設定します。空白のエントリは任意の IP からのアクセスを許可しますが、暴露リスクが大幅に増加します。

5. SMS または認証アプリ コードを介して作成を確認します。システムは API キーと秘密キーをすぐに表示します。秘密キーは 1 回だけ表示され、後で取得することはできません。

KuCoin 認証情報の保護と保存

1. API キーと秘密キーの両方を、プレーン テキスト ファイルやブラウザのメモリではなく、暗号化されたメモをサポートする安全なパスワード マネージャーにコピーします。

2. GitHub などのバージョン管理システムに秘密キーを決してコミットしないでください。代わりに .gitignore ルールと環境変数インジェクションを使用してください。

3. 大量の資産を処理する運用環境では、ハードウェア セキュリティ モジュール (HSM) または AWS Secrets Manager などのクラウドベースのシークレット マネージャーを統合します。

4. 90 日ごと、または侵害の疑い、従業員のオフボーディング、またはインフラストラクチャ移行イベントの直後にキーをローテーションします。

5. KuCoin の API アクティビティ ログを毎日監視して、予期しない IP の場所、リクエスト頻度の上昇、または不正な権限エスカレーションなどの異常がないか確認します。

KuCoin API統合のテスト

1. X-MBX-APIKEY ヘッダーを指定したcurlコマンドを使用して、基本的な接続を確認します（例：パブリック エンドポイントに対する GET /api/v1/timestamp）。

2. 認証されたエンドポイントの場合、KuCoin の公式 API リファレンスに記載されているように、HMAC-SHA256 と秘密キーを使用してリクエストに署名し、タイムスタンプと署名パラメータを含めます。

3. 応答コードを検証します。HTTP 200 は成功を確認します。 401 は無効な認証情報を示します。 429 シグナルのレート制限が枯渇しました。

4. 有効な権限スコープすべてにわたって機能テストを実行します。最初に、KuCoin のデモ取引環境で注文の発注、残高クエリ、出金の事前チェックを確認します。

5. 署名検証の失敗が 5 分間の枠内で 3 回の連続試行を超えた場合にアラートをトリガーする監視フックを展開します。

よくある質問

Q: 複数のアプリケーションで同じ API キーを再利用できますか? A: 技術的には可能ですが、使用しないことを強くお勧めします。各アプリケーションには、侵害時の影響範囲を最小限に抑えるために、範囲が狭い権限を持つ独自のキーが必要です。

Q: KuCoin では、読み取り専用キーであっても IP ホワイトリストが必要なのはなぜですか? A: 読み取り専用キーにより、ポートフォリオの機密データやリアルタイムの注文帳の深さが公開される可能性があります。IP 制限により、資格情報漏洩の悪用に対するネットワーク層の障壁が追加されます。

Q: 秘密キーを紛失した場合はどうなりますか? A: KuCoin には回復メカニズムがありません。侵害されたキーを削除し、新しいキーを生成し、それに応じてすべての統合を更新する必要があります。

Q: KuCoin API キーは OAuth 2.0 フローと互換性がありますか? A: いいえ。KuCoin は従来の API キー + シークレット HMAC 署名モデルのみを使用します。有効期間の短いトークンは発行されず、OpenID Connect プロトコルもサポートされません。