如何開始雙子API？

GEMINI API使開發人員可以使用HMAC-SHA384身份驗證來通過REST和Websocket安全訪問和市場數據，以實現安全的實時交互。

2025/08/05 12:35

了解雙子座API及其目的

Gemini API是加密貨幣交易所Gemini提供的強大界面，使開發人員能夠通過交易，帳戶和市場數據進行程序互動。該API支持REST和WebSocket協議，允許用戶檢索實時市場數據，放置交易，管理訂單和監視帳戶餘額。在進行實施之前，必須了解API是為具有HTTP請求，JSON格式和諸如HMAC-SHA384的身份驗證機制方面經驗的開發人員設計的。主要用例包括算法交易機器人，投資組合跟踪儀表板和自動化市場分析工具。

為了確保安全訪問，Gemini需要使用通過Gemini Web門戶生成的API鍵和秘密密鑰。這些憑據用於簽署每個請求，以確保只有授權用戶才能在交易所執行操作。 API支持沙箱和生產環境，使開發人員能夠在不冒險的情況下測試其集成。

創建雙子座帳戶並生成API密鑰

在使用Gemini API之前，您必須在Gemini平台上擁有一個註冊帳戶。導航到官方網站並完成註冊過程，包括必要時的身份驗證。登錄後，訪問帳戶設置部分，然後從菜單中選擇API 。在這裡，您將啟動創建新API密鑰的過程。

生成密鑰時，將提示您配置多個設置：

• 為您的API密鑰選擇一個名稱以幫助識別其目的
• 選擇交易權限（例如，僅查看，下訂單，取消訂單）
• 決定是否啟用提款（不建議在大多數用例中使用）
• 通過限制對特定IP地址的訪問來指定IP限制以增強安全性

確認您的選擇後，Gemini將生成一個公共API密鑰和一個私人秘密密鑰。私鑰只能顯示一次，因此請將其安全複製並存儲在加密環境中。失去此密鑰需要生成一個新的鍵，這使前一對無效。

建立開發環境

要開始使用Gemini API進行編碼，請使用必要的工具建立本地開發環境。安裝支持HTTP請求和加密功能的編程語言 - Python由於其簡單性和豐富的庫生態系統而是一個流行的選擇。使用PIP安裝所需的軟件包：

• 請求：進行HTTP調用
• HMAC和HASHLIB ：用於生成請求籤名
• JSON ：解析API響應

創建一個專用的項目文件夾，然後初始化配置文件（例如， config.py ），以安全地存儲API鍵。在主腳本中切勿硬碼憑據。而是使用環境變量或安全的配置管理系統。

示例配置設置：

 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 ：基本64編碼的JSON有效載荷
• X-Gemini-Signature ：基本64編碼的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，標頭=標題）
  打印（response.json（））

成功的響應返回JSON陣列，列出了您帳戶中的所有資產餘額。檢查HTTP狀態代碼和錯誤消息，以解決無效簽名或費率限制等問題。

使用Websocket Feed進行實時數據

對於實時市場數據，GEMINI API在wss://api.gemini.com/v1/marketdata/SYMBOL上提供了Websocket流。用交易對替換符號（例如， btcusd ）。該提要以最小的延遲提供了價格更新，訂購賬簿更改和貿易執行。

連接：

• 使用python中的WebSocket-Client之類的WebSocket客戶庫庫
• 使用JSON消息訂閱頻道：

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

• 在回調功能中處理傳入消息以處理出價/問更新

Websocket Feed是建立實時儀表板或高頻交易策略的理想選擇。注意連接超時並實施重新連接邏輯以獲得可靠性。

常見問題

如果被妥協，如何重置雙子座API密鑰？

登錄到您的雙子座帳戶，轉到API設置頁面，找到折衷的鍵，然後單擊“撤銷” 。立即生成新的密鑰對並更新應用程序的配置。撤銷後，所有以前的密鑰將永久無效。

我可以在沒有交易權限的情況下使用雙子座API嗎？

是的。在關鍵創建期間，僅在權限下選擇視圖。這允許餘額檢查和市場數據訪問，而無需啟用訂單放置或提款，從而增強了監視應用程序的安全性。

雙子座API執行什麼速率限制？

API根據請求類型施加速率限制。公共端點（例如，價格數據）允許更高的頻率，而私人端點每秒限於大約10個請求。超過限制導致HTTP 429響應。在您的代碼中實現延遲或指數向後，以保持合規性。

沙箱環境與生產相同嗎？

沙箱用基本URL https://api.sandbox.gemini.com反映生產終點。它使用測試資金和模擬的市場數據，從而完全測試訂單放置，取消和平衡跟踪而沒有財務風險。確保您的代碼可以無縫切換環境。