gate.ioで先物APIキーを作成する方法は？

先物取引許可を有効にし、セキュリティのためにIPホワイトリストを設定し、2FAを完了することにより、gate.ioで先物APIキーを作成し、シンプルなバランスフェッチリクエストでテストします。

2025/07/23 03:49

Gate.ioで先物APIキーを理解しています

Gate.ioのFutures APIキーを使用すると、トレーダーは取引戦略を自動化し、ポジションを管理し、プラットフォームからリアルタイム市場データを直接取得できます。スポットトレーディングキーとは異なり、先物取引許可に対して先物APIキーを明示的に有効にする必要があります。これにより、自動化されたシステムが意図した市場セグメントとのみ相互作用することが保証されます。開始するには、2要素認証（2FA）をアクティブにした検証済みのgate.ioアカウントがあることを確認してください。これは、APIキー作成に必須です。

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

gate.ioアカウントにログインし、ユーザーダッシュボードを見つけます。右上のコーナーで、プロフィールアイコンをクリックします。ドロップダウンメニューから、 「API管理」を選択します。このセクションでは、すべてのAPIキー（アクティブで非アクティブなもの）がリストされています。 APIキーを作成するのが初めての場合、リストは空になります。 [APIの作成]ボタンをクリックして、プロセスを開始します。ポップアップウィンドウが表示され、アクセス許可を設定し、制限を設定するように求められます。

先物取引の許可を構成します

API作成ウィンドウで、キーの範囲を指定する必要があります。 「許可」セクションで、次のチェックボックスを有効にします。

• 「先物取引」 - これは、先物の注文を配置してキャンセルするための重要なアクセスを許可します。
• 「先物アカウントの読み取り専用」 - キーがバランス、位置、および歴史データを取得できるようにします。
• （オプション）「転送」 - ボットがスポットアカウントと先物アカウントの間に資金を移動する必要がある場合にのみ有効にします。
  

  戦略が両方の市場に関係しない限り、「スポット取引」を有効にしないでください。妥協の場合に曝露を減らすために、キーをできるだけ最小限に抑えてください。

  セキュリティのためにIPホワイトリストの設定

  
  「IPホワイトリスト」フィールドの下に、アプリケーションがリクエストを送信する静的IPアドレスを入力します。 Gate.ioは、ここにリストされていないIPからAPI呼び出しを拒否します。ローカルでテストしている場合、または動的IPを使用している場合は、固定IPを持つVPSの使用を検討してください。コンマで分離することにより、複数のIPを追加できます。例えば：

• '192.168.1.100、203.0.113.50'

  このフィールドを空白のままにしておくと、APIキーは任意のIPから動作しますが、これは生産の使用には非常に落胆します。 IPSを入力した後、接続の問題を回避するためにタイプミスをダブルチェックしてください。

  2要素認証ステップを完了します

  
  キーを完成させる前に、gate.ioには2FAコードが必要です。提供されたフィールドに、Authenticatorアプリ（Google AuthenticatorやAuthyなど）によって生成されたコードを入力します。また、 「ファンドパスワード」を入力する必要があります。これは、ログインパスワードとは異なり、まだ完了していない場合はセキュリティ設定の下で事前に設定する必要があります。両方が検証されたら、 [確認]をクリックします。システムは、新しいAPIキーとシークレットキーを表示します。これらは一度だけ表示されます。すぐに安全なパスワードマネージャーまたは暗号化されたファイルにコピーします。
  

  簡単なリクエストでAPIキーをテストします

  
  キーワークを確認するには、 curlやPostmanなどのツールを使用してテストリクエストを送信します。たとえば、先物アカウントの残高を取得するには：

   curl -H 'KEY: YOUR_API_KEY' \ -H 'SIGN: YOUR_SIGNATURE' \ https://api.gate.io/api/v4/futures/usdt/accounts

  作成したキーにYOUR_API_KEYを置き換えます。署名（ SIGN ）は、secretキーとgate.ioのAPIドキュメントごとの要求パラメーターを使用して生成する必要があります。応答がJSON形式でバランスを返す場合、キーは機能的です。 403エラーが発生した場合は、IPホワイトリストと権限をもう一度確認してください。
  

  APIキーを安全に保存および管理します

  
  スクリプトやgithubリポジトリでAPIキーと秘密をハードコードしないでください。代わりに、環境変数を使用します。

• export gateio_api_key = 'your_actual_key'
• export gateio_api_secret = 'your_actual_secret'

  コードでは、それらos.getenv('GATEIO_API_KEY') （python）またはprocess.env.GATEIO_API_KEY （node.js）として参照してください。誤用が疑われる場合は、90日ごとにキーを回転させるか、すぐに回転させます。同じAPI管理ページからいつでもキーを無効または削除できます。

  ---

  よくある質問

  Q：スポット取引と先物取引の両方に同じAPIキーを使用できますか？
  
  はい。ただし、作成中に「スポット取引」と「先物取引」の両方の許可を明示的に有効にする場合のみです。より良いセキュリティのために、各市場に個別のキーを作成することをお勧めします。

  Q：秘密の鍵を失ったらどうすればよいですか？
  
  回復することはできません。侵害されたキーを削除し、新しいキーを作成する必要があります。古いキーを使用するアプリケーションは、新しい資格情報で更新されるまで動作を停止します。

  Q：先物取引を可能にした後でも、なぜ「許可を拒否された」エラーを取得しているのですか？
  
  リクエストが、スポットエンドポイントではなく、先物エンドポイント（ /api/v4/futures/usdt/... ）に送信されていることを確認してください。また、IPホワイトリストが正確なIPと一致して電話をかけることを確認します。

  Q：APIキーを制限して、注文の配置を許可せずに先物のポジションのみを読み取ることができますか？
  
  はい。セットアップ中、 「先物アカウントの読み取り専用」許可のみを有効にし、チェックされていない「先物取引」を残します。これにより、キーがデータのみを取得するためのキーが制限されます。