KucoinからAPIキーを取得する方法

限られた権限を備えたKucoin APIキーを生成し、2FAを有効にし、資格情報を安全に保存して、取引を安全に自動化するか、ポートフォリオを追跡します。

2025/08/08 18:50

KucoinのAPIキーの理解

APIキーは、Kucoinの取引プラットフォームとプログラムでやり取りしたいユーザーにとって不可欠なツールです。これらのキーを使用すると、外部アプリケーション、トレーディングボット、または個人のスクリプトを使用して、バランスのチェック、取引の配置、順序履歴の取得などのアクションについてKucoinアカウントにアクセスできます。各APIキーは、Kucoinのサーバーへの要求を認証する一意の識別子です。 APIキーがデフォルトで完全なアカウントアクセスを付与しないことを理解することが重要です。装飾は、取引のみを有効にしたり、引き出し能力を無効にしたりするなど、キーができることを制限するためにカスタマイズできます。

APIキーを生成する前に、Kucoinアカウントが2要素認証（2FA）で保護されていることを確認してください。これにより、特にAPIキーが機密操作を実行できるため、追加の保護層が追加されます。 Kucoinは、Google Authenticator、SMS、およびその他の2FAメソッドをサポートしています。 2FAを有効にしないと、APIキーの作成は許可されない場合があります。これは、交換によって課されるセキュリティ要件であるためです。

API管理セクションに移動します

APIキーを取得するプロセスを開始するには、公式WebサイトからKucoinアカウントにログインします。ログインしたら、画面の右上隅にあるプロフィールアイコンを見つけます。それをクリックして、ドロップダウンメニューを表示します。このメニューから、 「API」を選択します。これにより、既存のすべてのAPIキーがリストされているAPI管理ダッシュボードにリダイレクトされ、新しいキーを作成できます。

このセクションにアクセスするのが初めての場合、リストは空になる可能性があります。インターフェイスは、新しいAPIキーを作成し、アクティブキーを表示し、権限を管理するオプションを提供します。正しいアカウントタイプにあることを確認してください。クコインは標準とサブアカウントの両方をサポートし、APIキーがアカウントごとに生成されます。サブアカウントを使用している場合は、先に進む前にその特定のサブアカウントにログインしていることを確認してください。

新しいAPIキーを作成します

API管理ページで、 [APIの作成]ボタンをクリックします。ポップアップウィンドウが表示され、新しいキーを構成するように求められます。 APIキーの名前を入力するように求められます。これは参照用であり、「トレーディングボット」や「ポートフォリオトラッカー」などの説明的なものになる可能性があります。

次に、許可スコープを設定する必要があります。 Kucoinを使用すると、次の許可の1つ以上を割り当てることができます。

• 一般- アカウント情報とAPIステータスの表示を許可します。
• 読み取り- バランス、注文履歴、およびトランザクションレコードへのアクセスを可能にします。
• 取引- 注文の配置、変更、およびキャンセルを許可します。
• 撤回- アカウントから資金を引き出す能力を付与します。

絶対に必要な場合を除き、撤退許可を有効にすることを避けることを強くお勧めします。ほとんどのサードパーティのツールとボットは、読み取り許可と取引許可のみを必要とします。 APIキーが侵害された場合、引き出しアクセスを有効にすると、ファンドの損失のリスクが高まります。

セキュリティ検証を完了します

目的のアクセス許可を選択した後、セキュリティ検証ステップを完了する必要があります。 Kucoinは、電子メール検証コードと2FAコードを入力するように求められます。 6桁の検証コードを含むKucoinからのメッセージについては、登録された電子メール受信ボックスを確認してください。指定されたフィールドにこのコードを入力します。

次に、2FA認証アプリ（Google Authenticatorなど）を開き、Kucoinアカウントに表示されている現在の6桁のコードを入力します。この二重検証により、認定アカウント所有者のみがAPIキーを生成できることが保証されます。いずれかのコードが正しくない場合、プロセスは失敗し、再試行する必要があります。

両方のコードが正常に検証されると、システムはAPIキーとシークレットキーを生成します。これらの2つのコンポーネントが重要です。APIキーはアプリケーションを識別するために使用され、シークレットキーはセキュリティの要求に署名するために使用されます。どちらもこのプロセス中に一度だけ表示されます。

API資格情報の保護と保存

世代後、 APIキーとシークレットキーの両方をすぐにコピーします。 Kucoinは、セキュリティ上の理由で秘密の鍵を再び表示しません。紛失した場合は、現在のキーを削除して新しいキーを作成する必要があります。これらの資格情報を安全な場所に保存します。それらを共有したり、パブリックコードリポジトリにコミットしたりしないでください。

また、ユースケースで許可されている場合は、IP制限を設定することもお勧めします。 Kucoinを使用すると、APIキーを使用できるようにする特定のIPアドレスをホワイトライストできます。これは、誰かがあなたの資格情報を取得したとしても、不正な場所からそれらを使用できないことを意味します。 IP制限を有効にするには、キー作成中またはキー作成後に指定されたフィールドで使用することを計画している静的IPアドレスを入力します。

また、複数のキーを追跡するために、キーの目的と環境（「プロダクションボット - AWS IP」）にラベルを付けることもできます。アクティブなAPIキーを定期的に確認し、使用していないものを取り消します。

APIキーをテストします

APIキーが機能していることを確認するには、 CurlやPostmanなどのツールを使用して簡単なテストリクエストを作成できます。たとえば、アカウント残高を取得するには、次のエンドポイントを使用します。

 GET https://api.kucoin.com/api/v1/accounts

次のヘッダーを含める必要があります。

• KC-API-KEY ：APIキー
• KC-API-SIGN ：シークレットキーを使用して生成された署名
• KC-API-TIMESTAMP ：ミリ秒単位の現在のタイムスタンプ
• KC-API-PASSPHRASE ：設定したパスフレーズ（ある場合）

署名は、HMAC-SHA256を使用してシークレットキーを使用して、タイムスタンプ、HTTPメソッド、エンドポイント、要求本体の連結をエンコードすることによって作成されます。これにより、各リクエストが認証され、改ざん防止が保証されます。

よくある質問

秘密の鍵を失ったら回復できますか？

いいえ、Kucoinは作成後に秘密の鍵を保存しません。紛失した場合は、現在のAPIキーを削除して新しいキーを生成する必要があります。

サードパーティの取引ボットを備えたAPIキーを使用しても安全ですか？

許可を制限し、IPホワイトリストを使用すると安全になります。 APIアクセスを提供する前に、常にボットまたはサービスの正当性を確認してください。

KucoinでいくつのAPIキーを作成できますか？

Kucoinは、アカウントごとに複数のAPIキーを許可します。公的に述べられた制限はありませんが、必要なものだけを作成して慎重に管理することが最善です。

APIキーが侵害されていると思われる場合はどうすればよいですか？

すぐにAPI管理ページに移動し、疑わしいキーを見つけて、 [削除]をクリックします。削除後、必要に応じて新しいキーを作成し、新しい資格情報を使用してアプリケーションを更新します。