Kucoin Futures APIキーをセットアップする方法は？

Kucoin Futures APIキーを安全に使用し、API管理を介してそれらを作成し、2FAを有効にし、適切な権限を設定し、環境変数にキーをコードではなく保存します。

2025/07/25 18:43

Kucoin先物APIキーの理解

Kucoin Futures APIキーは、Kucoin先物取引プラットフォームとプログラムで相互作用する開発者、トレーダー、ボットにとって不可欠です。これらのキーを使用すると、注文を出し、アカウント情報を取得し、手動介入なしにポジションを管理できます。それらを安全に使用するには、APIキーとシークレットキーで構成されるキーペアを作成する必要があります。各キーは、資金や取引活動への不正アクセスを防ぐために、安全な環境に保存する必要があります。

Kucoin Futures APIダッシュボードへのアクセス

開始するには、公式WebサイトからKucoinアカウントにログインします。右上のコーナーに移動し、プロフィールアイコンをクリックします。ドロップダウンメニューから[API管理]を選択します。このセクションでは、すべてのAPIキー（スポットとフューチャーズの両方が作成され、管理されています。 2要素認証（2FA）を有効にしていない場合は、先に進む前にそうする必要があります。 2FAは、セキュリティ尺度としてKucoinのAPI作成に必須です。

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

API管理セクションに1回：

• [APIの作成]をクリックします。
• 利用可能なオプションから「Futures API」を選択します。
• APIキーの名前を入力します（例： "tradingbot_futures '）。
• 必要に応じてIPホワイトリストを選択します。これにより、API使用量が特定のIPアドレスに制限されます。
• 許可を確認します。注文を実行してアカウントデータを表示する場合は、「取引」と「読み取り」が有効になっていることを確認してください。
• [作成]をクリックします。
  

  その後、APIキーとシークレットキーを表示するポップアップを受け取ります。これは両方のキーが表示される唯一の時間であるため、パスワードマネージャーや暗号化されたファイルなどの安全な場所にすぐに保存してください。

  ボットまたはスクリプトを取引するためのAPIキーの構成

  
  これらのキーを取引ボットまたはPythonスクリプトで使用するには：
• 環境変数にAPIキーとシークレットを保存するか、コードベースの外側に構成ファイルを保存します。

• Pythonの例：

   import os from kucoin.client import Client api_key = os.getenv（ 'kucoin_api_key'）
  api_secret = os.getenv（ 'kucoin_api_secret'）

• Kucoin Futuresクライアントを初期化するときは、PassPhraseがAPI作成中に設定したクライアントと一致していることを確認してください。

  Kucoin先物API接続のテスト

  
  セットアップ後、接続をテストして動作することを確認します。

• get_account_overview()メソッドを使用して、先物アカウントの残高を取得します。

• 例：

   try: account_info = client.futures.get_account_overview() print('API connected successfully:', account_info) except Exception as e:

• 「API管理」の下でAPIキーを定期的に確認します。
• 未使用または侵害されたキーをすぐに取り消します。
• 高セキュリティセットアップのために定期的にキーを回転させます。新しいキーを作成し、ボットを更新してから、古いキーを削除します。
• 違反が疑われる場合は、キーを無効にし、Kucoinサポートに連絡してください。
• あなたの秘密の鍵やパスフレーズを誰とも共有しないでください。サポートスタッフは決して彼らを求めてはいけません。
  

  ---

  よくある質問

  Q：クコインスポットと先物の両方に同じAPIキーを使用できますか？
  
  いいえ。KUCOINには、スポットと先物取引に個別のAPIキーが必要です。先物にスポットAPIキーを使用すると、許可エラーが発生します。 Futures Endpointに接続するときは、常に専用のFutures APIキーを作成します。

  Q：APIを作成した後に秘密の鍵を失ったらどうすればよいですか？
  
  失われた秘密の鍵を回復することはできません。既存のAPIキーを削除し、新しいキーを作成する必要があります。作成直後の新しい資格情報でボットまたはアプリケーションを更新します。

  Q：API要求が「許可を拒否された」エラーを返すのはなぜですか？
  
  これは通常、API作成中に選択された権限が不十分であったことを意味します。注文の配置とアカウントデータアクセスのために、 「取引」および「読み取り」権限が有効になっていることを確認してください。また、正しいエンドポイント（先物対スポット）を使用していることを確認します。

  Q：VPSまたはクラウドサーバーでAPIキーを使用しても安全ですか？
  
  はい、サーバーが安全な場合。 IPホワイトリストを介してAPI使用量をVPS IPに制限し、ログや公開リポジトリでキーを公開しないでください。環境変数または暗号化されたストレージを使用して、資格情報を保護します。