发布于 2025-01-04 10:42:34 · 阅读量: 42253

Gemini API 接口使用指南

Gemini 是一个知名的加密货币交易平台，提供了强大的 API 接口，允许用户进行自动化交易、账户管理和市场数据查询。通过 Gemini API，开发者和交易者可以实现高度定制的交易策略，并与平台的各项功能进行深度集成。今天，我们将详细介绍 Gemini API 接口的使用方法。

1. Gemini API 简介

Gemini 提供的 API 基本上包括了两类：Public API 和 Private API。

• Public API：允许访问公共的市场数据，如行情、历史数据等。
• Private API：需要身份验证，允许访问与账户相关的数据，如账户余额、订单管理、交易等功能。

要使用 Gemini API，首先你需要在 Gemini 账户中生成一个 API 密钥。

2. 创建 API 密钥

1. 登录你的 Gemini 账户。
2. 进入 API 设置页面。
3. 点击 "Create New API Key"。
4. 设置权限，选择你所需的权限（比如读取市场数据、交易、管理账户等）。
5. 记录生成的 API 密钥和密钥 ID。不要泄露这些密钥，避免安全问题。

3. 安装请求库

为了与 Gemini API 进行交互，我们需要安装一些常用的请求库。以下是使用 Python 语言进行 API 调用的常见库。

bash pip install requests pip install pycryptodome

4. 使用 Public API 查询市场数据

Gemini 的 Public API 允许我们查询实时的市场行情。下面是一个简单的 Python 示例，展示如何获取某个交易对（如 BTC/USD）的最新市场价格。

import requests

url = "https://api.gemini.com/v2/ticker/btcusd" response = requests.get(url)

if response.status_code == 200: data = response.json() print(f"当前 BTC/USD 的价格是: ${data['last']}") else: print("请求失败，请检查 API 是否正常")

这个接口不需要 API 密钥，因为它是公开的。

5. 使用 Private API 执行交易

如果你需要执行如下单、取消订单等涉及账户的操作，则必须使用 Private API。在这种情况下，你需要使用生成的 API 密钥进行身份验证。

5.1 签名和认证

每个 Private API 请求都必须经过签名，以确保安全性。Gemini API 要求请求在头部包含 API 密钥、签名和请求时间戳。

下面是一个如何发送带有签名的请求的示例。

import requests import time import hmac import hashlib import base64 import json

配置

api_key = "your_api_key" api_secret = "your_api_secret" url = "https://api.gemini.com/v1/order/new" nonce = str(int(time.time() * 1000)) # 当前时间戳（毫秒） body = { "request": "/v1/order/new", "nonce": nonce, "symbol": "btcusd", "amount": "0.01", "price": "50000", "side": "buy", "type": "exchange limit" }

请求的正文需要进行 JSON 序列化

body_json = json.dumps(body)

创建签名

signature = hmac.new( base64.b64decode(api_secret), msg=body_json.encode("utf-8"), digestmod=hashlib.sha384 ).hexdigest()

设置头部

headers = { "Content-Type": "text/plain", "X-GEMINI-APIKEY": api_key, "X-GEMINI-PAYLOAD": base64.b64encode(body_json.encode("utf-8")).decode("utf-8"), "X-GEMINI-SIGNATURE": signature }

发起请求

response = requests.post(url, headers=headers, data=body_json)

if response.status_code == 200: print("订单成功创建:", response.json()) else: print("订单创建失败:", response.text)

5.2 下单

上面的代码示例展示了如何使用 Gemini Private API 创建一个限价单。你可以更改请求体中的参数来创建不同类型的订单。常见的订单类型包括：

• exchange limit：限价单
• market：市价单
• stop limit：止损限价单
• stop market：止损市价单

通过调整 "type" 和其他参数，你可以实现自定义交易策略。

6. 查询账户余额

要查询账户余额，你可以调用 /v1/balances 接口，该接口将返回账户中所有资产的信息。这里是一个使用 Python 查询余额的例子。

url = "https://api.gemini.com/v1/balances" response = requests.get(url, headers=headers)

if response.status_code == 200: balances = response.json() for balance in balances: print(f"币种: {balance['currency']}, 可用余额: {balance['available']}") else: print("查询余额失败:", response.text)

7. 处理错误和异常

当你与 Gemini API 进行交互时，处理错误和异常非常重要。API 返回的错误信息通常是 JSON 格式，可以帮助你调试和排查问题。

典型的错误响应如下：

json { "error": "Unauthorized", "message": "Invalid API key or signature" }

你可以根据错误代码和消息调整代码，确保每次请求都能成功。

8. 限制和速率限制

Gemini API 对请求频率有一定的限制。通常，Public API 允许你每秒发送多个请求，而 Private API 由于涉及账户操作，通常会受到更严格的限制。过多的请求可能导致被临时封禁。可以参考 Gemini 的官方文档来了解更详细的限流策略。

9. 结语

使用 Gemini API，可以轻松地实现自动化交易和账户管理。通过 Public 和 Private API 的结合，交易者不仅能够获取实时的市场数据，还能够执行各种交易操作。掌握 API 的使用，能够帮助你在加密货币交易的世界中更加高效地操作，提升交易体验。