Gemini APIを始める方法は？

Gemini APIにより、開発者は、安全でリアルタイムのインタラクションのためにHMAC-Sha384認証を使用して、RESTとWebSocketを介して取引と市場のデータを安全にアクセスできます。

2025/08/05 12:35

Gemini APIとその目的を理解する

Gemini APIは、暗号通貨交換Geminiによって提供される強力なインターフェイスであり、開発者が取引、アカウント、および市場データとプログラム的にやり取りできるようにします。このAPIは、 RESTプロトコルとWebSocketプロトコルの両方をサポートしているため、ユーザーはリアルタイム市場データを取得し、取引を配置し、注文を管理し、アカウントの残高を監視できます。実装に飛び込む前に、APIは、HTTPリクエスト、JSONのフォーマット、HMAC-Sha384などの認証メカニズムの経験を持つ開発者向けに設計されていることを理解することが不可欠です。主なユースケースには、アルゴリズムトレーディングボット、ポートフォリオ追跡ダッシュボード、自動化された市場分析ツールが含まれます。

安全なアクセスを確保するために、GeminiはGemini Webポータルを介して生成されるAPIキーとシークレットキーを使用する必要があります。これらの資格情報は、各リクエストに署名するために使用され、認定ユーザーのみが取引所でアクションを実行できるようにします。 APIは、サンドボックス環境と生産環境の両方をサポートしているため、開発者は実際の資金を危険にさらすことなく統合をテストできます。

Geminiアカウントの作成とAPIキーの生成

Gemini APIを使用する前に、Geminiプラットフォームに登録アカウントが必要です。公式ウェブサイトに移動し、必要に応じて身元確認を含む登録プロセスを完了します。ログインしたら、アカウント設定セクションにアクセスし、メニューからAPIを選択します。ここでは、新しいAPIキーを作成するプロセスを開始します。

キーを生成すると、いくつかの設定を設定するように求められます。

• APIキーの名前を選択して、その目的を特定するのに役立ちます
• 取引許可を選択します（例：表示のみ、注文を配置し、注文をキャンセルします）
• 引き出しを有効にするかどうかを決定します（ほとんどのユースケースには推奨されません）
• 特定のIPアドレスへのアクセスを制限することにより、セキュリティを強化するためのIP制限を指定します

選択を確認した後、ジェミニはパブリックAPIキーとプライベートシークレットキーを生成します。秘密鍵は一度だけ表示されるため、暗号化された環境に安全にコピーして保存します。このキーを失うには、新しいキーを生成する必要があります。これにより、前のペアが無効になります。

開発環境のセットアップ

Gemini APIでコーディングを開始するには、必要なツールを備えたローカル開発環境を設定します。 HTTPリクエストと暗号化機能をサポートするプログラミング言語をインストールします。Pythonは、そのシンプルさと豊富なライブラリエコシステムのために人気のある選択肢です。 PIPを使用して、必要なパッケージをインストールします。

• リクエスト：HTTP呼び出しを行うため
• HMACおよびHASHLIB ：リクエスト署名を生成するため
• JSON ：API応答の解析用

専用のプロジェクトフォルダーを作成し、APIキーを安全に保存する構成ファイル（ config.pyなど）を初期化します。メインスクリプトのハードコード資格情報は絶対にありません。代わりに、環境変数または安全な構成管理システムを使用します。

設定の例のセットアップ：

 import os
 API_KEY = os.getenv('GEMINI_API_KEY')
 API_SECRET = os.getenv('GEMINI_API_SECRET').encode()

これらの環境変数をシェルに設定するか、 Python-Dotenvなどのパッケージを使用して.envファイルを使用します。このプラクティスは、機密データを誤って暴露するリスクを最小限に抑えます。

HMAC-Sha384での認証リクエスト

Gemini APIへのすべての認証された要求には、HMAC-Sha384を使用して生成されたデジタル署名を含める必要があります。この署名は、プライベートシークレットキーとリクエストの詳細を含むJSONペイロードを使用して作成されます。このプロセスには、いくつかの正確なステップが含まれます。

• 次のフィールドでJSONオブジェクトを作成します。

  • リクエスト：APIエンドポイントパス（例： /v1/balances ）
  • Nonce ：ユニークで増分する整数（通常、ミリ秒単位の現在のタイムスタンプ）
  • シンボル（該当する場合）：トレーディングペア（例： 'btcusd'））

• JSONペイロードをASCIIにエンコードします

• シークレットキーを使用してHMAC-SHA384ハッシュを生成します

• 結果の署名をBase64形式でエンコードします

HTTPリクエストに次のヘッダーを含めます。

• コンテンツタイプ：アプリケーション/JSON
• コンテンツレングス：ペイロードの長さ
• X-Gemini-Apikey ：パブリックAPIキー
• X-Gemini-Payload ：Base64エンコードJSONペイロード
• X-Gemini-Signature ：Base64エンコードHMAC署名

この正確な形式に従わないと、認証エラーが発生します。 /v1/balancesのような単純なエンドポイントで署名ロジックをテストして、正確性を確認します。

最初のAPIリクエストを実行します

認証が構成されたら、最初のAPI呼び出しを行うことができます。以下は、Pythonを使用してアカウントバランスを取得する例です。

• 必要なライブラリをインポートします：

   import requests
   import json
   import hmac
   import time

• エンドポイントとヘッダーを定義します。

   url = 'https://api.gemini.com/v1/balances'
   nonce = int(time.time() * 1000)
   payload = {'request': '/v1/balances', 'nonce': nonce}
   encoded_payload = json.dumps(payload).encode()
   b64_payload = base64.b64encode(encoded_payload).decode()
   signature = hmac.new(API_SECRET, b64_payload.encode(), hashlib.sha384).hexdigest()

• ヘッダーを設定してリクエストを送信します。

   headers = { 'Content-Type': 'text/plain', 'Content-Length': '0', 'X-GEMINI-APIKEY': API_KEY, 'X-GEMINI-PAYLOAD': b64_payload, 'X-GEMINI-SIGNATURE': signature

  }
  応答= requests.post（url、headers = headers）
  print（respons.json（））

応答が成功すると、アカウント内のすべての資産残高をリストするJSONアレイが返されます。 HTTPステータスコードとエラーメッセージを検査して、無効な署名やレートの制限などの問題をトラブルシューティングします。

リアルタイムデータにWebSocketフィードを使用します

リアルタイム市場データの場合、Gemini APIはwss://api.gemini.com/v1/marketdata/SYMBOLでWebSocketストリームを提供します。シンボルをトレーディングペアに置き換えます（例： btcusd ）。このフィードは、価格の更新、注文帳の変更、および最小限の遅延で取引実行を提供します。

接続する：

• PythonのWebSocket-ClientのようなWebSocketクライアントライブラリを使用します
• JSONメッセージを使用してチャンネルを購読します。

   {
   'type': 'subscribe',
   'subscriptions': [{'name': 'l2', 'symbols': ['btcusd']}]
   }

• コールバック関数で着信メッセージを処理して、入札/更新を処理します

WebSocketフィードは、リアルタイムのダッシュボードや高周波取引戦略を構築するのに最適です。接続タイムアウトに注意し、信頼性のための再接続ロジックを実装してください。

よくある質問

Gemini APIキーが侵害された場合にリセットするにはどうすればよいですか？

Geminiアカウントにログインし、 API設定ページに移動し、侵害されたキーを見つけて、 [Recked]をクリックします。新しいキーペアをすぐに生成し、アプリケーションの構成を更新します。以前のすべてのキーは、取り消し時に永久に無効になります。

取引権限なしでGemini APIを使用できますか？

はい。キー作成中、[許可]の下でのみビューを選択します。これにより、注文の配置や引き出しを可能にすることなく、バランスチェックと市場データアクセスが可能になり、アプリケーションの監視のセキュリティが強化されます。

Gemini APIはどのようなレート制限を実施しますか？

APIは、要求タイプに基づいてレート制限を課します。パブリックエンドポイント（例、価格データ）はより高い頻度を可能にしますが、プライベートエンドポイントは毎秒約10のリクエストに制限されます。制限を超えると、HTTP 429応答が発生します。コンプライアンスを維持するために、コードに遅延または指数バックオフを実装します。

サンドボックス環境は生産と同じですか？

サンドボックスは、ベースのURL https://api.sandbox.gemini.com備えた生産エンドポイントを反映しています。テストファンドとシミュレートされた市場データを使用して、財政的リスクなしに注文配置、キャンセル、バランストラッキングの完全なテストを可能にします。コードが環境をシームレスに切り替えることができることを確認してください。