如何开始双子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反映生产终点。它使用测试资金和模拟的市场数据，从而完全测试订单放置，取消和平衡跟踪而没有财务风险。确保您的代码可以无缝切换环境。