自動取引にGemini APIを使用する方法は？

Gemini APIは、開発者が認証されたHTTPリクエストを介して市場データを安全にアクセスし、注文し、アカウントを管理できるようにすることにより、自動取引を可能にします。

2025/08/04 02:08

Gemini APIと自動取引におけるその役割を理解する

Gemini APIは、開発者とトレーダーがGemini Cryptocurrency Exchangeとプログラム的に対話できるようにする強力なツールです。 APIを使用することにより、ユーザーは市場データを取得し、取引を配置し、注文を管理し、Webインターフェイスを手動でナビゲートすることなくアカウントの残高を監視できます。 Geminiでの自動取引の基礎は、適切な認証とリアルタイムデータに基づいて戦略を実行することでこのAPIにアクセスすることにあります。まず、開発者はGeminiアカウントからAPIキーを生成する必要があります。これは、APIキーと対応する秘密で構成されています。これらの資格情報は、リクエストに署名し、安全な通信を確保するために使用されます。 2要素認証（2FA）を有効にし、セキュリティリスクを最小限に抑えるために、取引または読み取り専用アクセスのみを許可するなど、意図した使用に基づいてAPIキーアクセス権を制限することが重要です。

開発環境を設定します

コードを作成する前に、開発環境が必要なツールをサポートしていることを確認してください。ほとんどの開発者は、そのシンプルさと豊富なライブラリエコシステムのためにPythonを使用しています。 requestsリクエストを処理するためにリクエストライブラリをインストールし、リクエストの署名のためにpycryptodomeまたはcryptography 。 PIP経由でこれらをインストールできます。

• pip install requests pycryptodome

専用のプロジェクトフォルダーを作成し、仮想環境を初期化して依存関係を分離します。 APIキーとシークレットを安全な構成ファイルまたは環境変数に保存します。スクリプトにハードカードしないでください。環境変数の例：

• GEMINI_API_KEY='your_api_key_here'
• GEMINI_API_SECRET='your_secret_here'

環境変数を使用すると、特にコードを共有する場合、またはGITなどのバージョン制御システムを使用する場合、偶発的な曝露を防ぎます。

Gemini APIへのリクエストの認証

GeminiへのすべてのプライベートAPI要求は、HMAC-Sha384暗号化を使用して認証される必要があります。このプロセスには、リクエストの詳細とタイムスタンプを含むJSONペイロードを構築し、APIの秘密に署名することが含まれます。ペイロードを構築する方法は次のとおりです。

• エンドポイントパスを含めます
• NonCEを追加します（一意の、増分数またはタイムスタンプ）
• 該当する場合は、リクエスト本体を指定します

ペイロードの例：

 {'request': '/v1/balances', 'nonce': 1234567890}

このペイロードをBase64でエンコードし、秘密を使用してHMAC署名を生成します。 HTTPリクエストで次のヘッダーを設定します。

• X-GEMINI-APIKEY ：APIキー
• X-GEMINI-PAYLOAD ：base64エンコードペイロード
• X-GEMINI-SIGNATURE ：HMAC署名の16進表現

署名が正しくないと、401の不正エラーが発生します。 /v1/balancesエンドポイントを使用してアカウント残高を取得して認証をテストします。

取引決定のために市場データの取得

自動取引システムは、正確でリアルタイムの市場データに依存しています。 Gemini APIは、この目的のためにいくつかのパブリックエンドポイントを提供します。 /v1/pubticker/symbolエンドポイントを使用して、特定の取引ペアの最新の価格、入札、尋ね、ボリュームを取得します。たとえば、BTC/USDのデータを取得するには：

• https://api.gemini.com/v1/pubticker/btcusdにGETリクエストを送信します

応答には以下が含まれます。

• 「Ask」 ：最低の販売価格
• 「入札」 ：現在の最新の買い価格
• 「最後」 ：最新の取引価格
• 「ボリューム」 ：24時間以上の取引量

履歴データについては、 /v2/candles/symbol/timeframeエンドポイントを使用して、OHLC（オープン、ハイ、ロー、クローズ）データを返します。サポートされている時間枠には、 1m 、 5m 、 15m 、 30m 、 1h 、 6h 、および1dが含まれます。このデータは、バックテスト戦略と傾向を特定するために不可欠です。

プログラムで注文の配置と管理

システムが市場の洞察を得ると、取引を実行できます。注文配置の主要エンドポイントは/v1/order/newです。これには、署名されたペイロードを含むPOSTリクエストが必要です。

• 「シンボル」 ：トレーディングペア（例： 'btcusd'）
• 「金額」 ：売買する量
• 「価格」 ：価格を米ドルの制限
• 「サイド」 ：「買い」または「販売」
• 「タイプ」 ：通常「交換制限」

ペイロードの例：

 {
 'request': '/v1/order/new',
 'nonce': 1234567891,
 'symbol': 'btcusd',
 'amount': '0.01',
 'price': '50000.00',
 'side': 'buy',
 'type': 'exchange limit'
 }

提出後、APIは注文ID 、ステータス、および実行の詳細を返します。アクティブな注文を監視するには、 /v1/ordersを使用してすべてのオープン注文を取得します。ペイロードに注文IDを含めることにより/v1/order/cancel 。 /v1/order/statusを使用して、充填額と平均価格を含む特定の注文の実行ステータスを確認します。

基本的な取引ボットの実装

簡単な取引ボットは、事前定義されたルールに基づいて価格をチェックし、注文を配置するループを使用して構築できます。しきい値を定義することから始めます。BTC価格が50,000ドルを下回った場合は、0.01 BTCを購入します。ボットは次のとおりです。

• /v1/pubticker/btcusdを使用して現在のBTC/USD価格を取得します
• JSON応答から「最後の」価格を解析します
• しきい値と比較してください
• 条件が満たされ、オープンオーダーが存在しない場合は、購入注文を作成して送信します

time.sleep()を使用してレート制限を回避します - Geminiでは、ほとんどのエンドポイントで1分あたり120リクエストを許可します。ネットワークの問題とAPIレートの制限のエラー処理を実装します（HTTP 429）。すべてのアクションをデバッグと監査のためにファイルにログに記録します。機能を強化するには、 pandasなどのライブラリを使用して平均移動などのテクニカルインジケーターを統合します。

よくある質問

検証済みのアカウントなしでGemini APIを使用できますか？

いいえ。取引権限を持つAPIキーを生成するには、完全に検証されたGeminiアカウントが必要です。未検証のアカウントは、プライベートエンドポイントにアクセスしたり、取引を実行したりすることはできません。

Gemini APIのレート制限はいくらですか？

Geminiは、ほとんどのエンドポイントで1分あたり120のリクエストの制限を実施します。これを超えると、429のリクエスト応答が多すぎます。コードに遅延または指数バックオフを実装して、制限内にとどまります。

WebSocketサポートはリアルタイムデータで利用できますか？

はい。 Geminiはwss://api.gemini.com/v1/marketdata/symbolでWebSocketフィードを提供しています。これにより、入札、尋ね、取引に関するリアルタイムの更新が提供されます。 「top_of_book」や「auction_events」などのシンボルとオプションのフィールドを使用してJSONメッセージを送信して購読します。

APIキーの妥協をどのように処理しますか？

すぐにGeminiアカウントにログインし、API設定に移動し、妥協したキーを取り消します。新しいものを生成し、アプリケーションの構成を更新します。可能であれば、信頼できるサーバーへのアクセスを制限するために、IPホワイトリストを有効にします。