Gemini API交易接口配置指南：步骤详解与安全建议

• API Key (公钥): 用于标识你的账户，可以公开分享。
• Secret Key (私钥): 用于对请求进行签名，务必妥善保管，切勿泄露给任何人。 泄露 Secret Key 会导致你的账户被盗用。

下载或复制 API Key 和 Secret Key，并将其安全地存储在你的开发环境中。

• Linux/macOS: 在 .bashrc 或 .zshrc 文件中添加：

  bash export GEMINIAPIKEY="YOURAPIKEY" export GEMINISECRETKEY="YOURSECRETKEY"

  然后执行 source .bashrc 或 source .zshrc 以使环境变量生效。

• Windows: 在“系统属性” -> “高级” -> “环境变量”中添加新的系统变量 GEMINI_API_KEY 和 GEMINI_SECRET_KEY。

• Python:

  以下代码演示了如何使用Python生成符合Gemini交易所API要求的签名，用于进行身份验证和安全通信。它涉及密钥管理、数据编码和哈希运算等关键步骤。

  import hashlib
  引入Python的 hashlib 库，该库提供了多种安全的哈希算法，例如SHA-384，用于生成消息摘要。

  import hmac
  引入 hmac 库，用于计算带有密钥的消息认证码（HMAC），确保数据的完整性和真实性，防止篡改。

  import base64
  引入 base64 库，用于将二进制数据编码为ASCII字符串，方便在HTTP请求中传输数据。

  import
  引入 库，用于处理JSON格式的数据，包括序列化（将Python对象转换为JSON字符串）和反序列化（将JSON字符串转换为Python对象）。

  import os
  引入 os 库，用于访问操作系统环境变量，从中读取API密钥和密钥，避免硬编码敏感信息。

  api_key = os.environ.get('GEMINI_API_KEY')
  从环境变量 GEMINI_API_KEY 中获取API密钥，API密钥用于标识您的身份。

  secret_key = os.environ.get('GEMINI_SECRET_KEY')
  从环境变量 GEMINI_SECRET_KEY 中获取密钥，密钥用于生成签名，验证请求的真实性。

  def generate_signature(payload):
  定义一个名为 generate_signature 的函数，该函数接受一个 payload （有效载荷）参数，该参数通常是一个包含API请求数据的Python字典。

  encoded_payload = base64.b64encode(.dumps(payload).encode('utf-8'))
  使用 .dumps(payload) 将 payload 字典转换为JSON字符串。然后，使用 .encode('utf-8') 将JSON字符串编码为UTF-8字节串。使用 base64.b64encode() 将UTF-8字节串进行Base64编码，得到编码后的有效载荷。

  signature = hmac.new(secret_key.encode('utf-8'), encoded_payload, hashlib.sha384).hexdigest()
  使用 hmac.new() 创建一个HMAC对象，其中： secret_key.encode('utf-8') 是密钥的UTF-8字节串， encoded_payload 是编码后的有效载荷， hashlib.sha384 指定使用的哈希算法为SHA-384。然后，使用 .hexdigest() 方法将HMAC对象转换为十六进制字符串，作为签名。

  return encoded_payload.decode('utf-8'), signature
  函数返回两个值：Base64编码后的有效载荷（解码为UTF-8字符串）和生成的签名。

  发送 HTTP 请求: 使用 HTTP 请求库发送 API 请求。 根据请求类型 (GET, POST, 等)，选择相应的 HTTP 方法。
• 处理响应: 解析 API 响应，并处理可能出现的错误。 Gemini API 返回的响应通常是 JSON 格式。

5. 示例代码 (Python)

以下是一个使用 Python 发送请求获取账户信息的示例代码，用于访问 Gemini 交易所的 API。该示例展示了如何构建经过身份验证的 API 请求，以获取用户的账户余额信息。它涵盖了 API 密钥的管理、请求的签名生成以及响应的处理。

import requests import import os import hashlib import hmac import base64 import time

api url = 'https://api.gemini.com' api key = os.environ.get('GEMINI API KEY') secret key = os.environ.get('GEMINI SECRET_KEY')

def generate signature(payload): """ 生成 Gemini API 请求的签名。 Args: payload (dict): 包含请求数据的字典。 Returns: tuple: 包含编码后的 payload 和签名的元组。 """ encoded payload = base64.b64encode(.dumps(payload).encode('utf-8')) signature = hmac.new(secret_key.encode('utf-8'), encoded_payload, hashlib.sha384).hexdigest() return encoded_payload.decode('utf-8'), signature

def get account info(): """ 获取 Gemini 账户的余额信息。 """ endpoint = '/v1/balances' url = api url + endpoint payload = { 'request': endpoint, 'nonce': str(int(round(time.time() * 1000))) } encoded payload, signature = generate_signature(payload)

headers = {
    'Content-Type': 'application/',
    'X-GEMINI-APIKEY': api_key,
    'X-GEMINI-PAYLOAD': encoded_payload,
    'X-GEMINI-SIGNATURE': signature,
    'Cache-Control': 'no-cache'
}

try:
    response = requests.post(url, headers=headers)
    response.raise_for_status() # 检查是否有 HTTP 错误
    if response.status_code == 200:
        print(.dumps(response.(), indent=4))
    else:
        print(f"Error: {response.status_code} - {response.text}")

except requests.exceptions.RequestException as e:
    print(f"Request failed: {e}")

get account info()

这段代码演示了如何构建 API 请求，包括创建 payload、计算 HMAC SHA384 签名、设置必要的 HTTP 头部以及发送 POST 请求。错误处理机制也被添加，以便在请求失败时提供更详细的信息。请确保将 GEMINI_API_KEY 和 GEMINI_SECRET_KEY 设置为环境变量，或者直接在代码中替换为你自己的 API 密钥和 Secret Key。该代码还使用 requests.exceptions.RequestException 来捕获和处理由于网络问题或其他原因导致的请求失败情况。务必安装 requests 库 ( pip install requests ) 以运行此代码。

6. 安全注意事项

• 妥善保管 Secret Key: 这是至关重要的一点。 Secret Key 一旦泄露，相当于将账户的控制权拱手让人，极易导致账户资金被盗用。强烈建议使用硬件钱包或离线存储等方式，对 Secret Key 进行高强度保护。 定期更换 Secret Key 也是一种有效的安全措施，即便旧的 Key 泄露，也能将损失降到最低。
• 使用环境变量存储 API 密钥: 避免将 API 密钥直接硬编码在代码中，这会使密钥暴露在版本控制系统或日志文件中，大大增加被盗风险。 通过环境变量存储 API 密钥，可以将其与代码分离，并易于在不同环境之间切换。同时，应确保运行环境本身的安全，例如服务器的访问权限控制。
• 遵循最小权限原则: 只为 API 密钥授予完成特定任务所需的最小权限集。避免授予不必要的权限，以降低潜在风险。 例如，如果 API 密钥仅用于读取市场数据，则不应授予其执行交易或提现的权限。仔细审查 Gemini 平台提供的不同权限选项，并根据实际需求进行配置。
• 定期审查 API 密钥权限: 定期检查 API 密钥的权限设置，确保其仍然符合当前的使用需求。 如果某个密钥不再需要某些权限，应立即将其撤销。 还可以考虑设置密钥的有效期，到期后自动失效，以防止长期不用的密钥被恶意利用。
• 启用双重验证 (2FA): 在 Gemini 账户上启用双重验证，为账户增加额外的安全保障。 即使密码泄露，攻击者也需要通过第二重验证才能登录账户。 建议使用基于时间的一次性密码 (TOTP) 的 2FA 方式，例如 Google Authenticator 或 Authy。
• 使用安全的网络连接: 避免在公共 Wi-Fi 网络等不安全的网络环境下进行交易操作。 公共 Wi-Fi 网络容易受到中间人攻击，攻击者可能截获您的登录信息或交易数据。 建议使用 VPN 或移动数据网络等安全的网络连接进行交易操作。 定期检查网络安全设置，确保防火墙和杀毒软件处于最新状态。