Coinbase Pro API 文档

Coinbase Pro API 文档：初学者指南

Coinbase Pro API (现在称为 Coinbase Advanced Trade API) 是一个强大的工具，允许交易者以编程方式访问 Coinbase Pro 交易所的数据和功能。对于希望构建自动交易机器人、执行大规模订单或将交易策略集成到现有系统中的加密货币交易者来说，它至关重要。本文将为初学者提供一个全面的指南，涵盖 API 的核心概念、认证、常见用例和最佳实践。

1. 什么是 Coinbase Pro API？

Coinbase Pro API 是一组 RESTful API 端点，允许开发者与 Coinbase Pro 交易所进行交互。与手动在 Coinbase Pro 网站上交易不同，API 允许您通过代码自动执行各种任务，例如：

• 获取市场数据：实时价格、订单簿、交易历史等。
• 下单：市价单、限价单、止损单等。
• 管理账户：查看余额、交易历史、存款和提款。
• 访问历史数据：用于回测和策略优化。

使用 API 的优势包括：

• 速度： 自动化交易比手动交易快得多，尤其是在波动性较大的市场中。
• 效率： 自动化可以减少人为错误和交易延迟。
• 可扩展性： API 允许您处理大量订单和数据，而无需手动干预。
• 灵活性： 您可以根据自己的特定需求定制交易策略。

加密货币交易所的API是量化交易的基础。

2. API 认证

在使用 Coinbase Pro API 之前，您需要创建一个开发者账户并生成 API 密钥。以下是步骤：

1. 创建 Coinbase 账户： 如果您还没有 Coinbase 账户，请先创建一个。
2. 访问开发者页面： 登录 Coinbase 后，访问 Coinbase Developer Portal。
3. 创建应用： 点击“创建应用”并填写必要的详细信息，例如应用名称和回调 URL (可选)。
4. 生成 API 密钥： 创建应用后，您将获得一个 API 密钥和一个 API 密钥短语。 务必安全地保存这些密钥，因为它们是访问您 Coinbase 账户的唯一凭证。 不要将密钥分享给任何人或将其存储在不安全的位置。
5. 权限管理： 在创建应用时，您可以指定 API 密钥的权限。 谨慎选择权限，只授予应用程序执行其所需的操作的权限。例如，如果您的应用只需要读取市场数据，则不需要授予其下单权限。

API 密钥类型

Coinbase Pro API 提供多种 API 密钥类型，每种类型都具有不同的权限：

类型 描述 权限 API 密钥 用于身份验证和授权。 读取、下单、取消订单、管理账户 API 密钥短语 与 API 密钥一起用于签名请求。 同 API 密钥 OAuth 2.0 客户端 ID 用于 OAuth 2.0 授权流程。 仅用于 OAuth 应用 OAuth 2.0 客户端密钥 用于 OAuth 2.0 授权流程。 仅用于 OAuth 应用

3. API 端点概览

Coinbase Pro API 提供了一系列端点，用于访问不同的功能。以下是一些常用的端点：

• /products： 获取可交易产品的列表。 交易对
• /products/{product-id}/ticker： 获取特定产品的实时价格信息。 技术指标
• /products/{product-id}/book： 获取特定产品的订单簿信息。 订单簿分析
• /products/{product-id}/trades： 获取特定产品的交易历史记录。 交易量分析
• /accounts： 获取您的账户列表。
• /accounts/{account-id}/balance： 获取特定账户的余额。
• /orders： 下单。 订单类型
• /orders/{order-id}： 获取特定订单的信息。
• /orders/{order-id}/cancel： 取消特定订单。

完整的 API 文档可以在 Coinbase Advanced Trade API Documentation 中找到。

4. 常见用例与代码示例 (Python)

以下是一些使用 Coinbase Pro API 的常见用例以及相应的 Python 代码示例 (使用 requests 库):

4.1 获取比特币 (BTC-USD) 的实时价格

import requests

api_key = "YOUR_API_KEY"
api_secret = "YOUR_API_SECRET"
product_id = "BTC-USD"

url = f"https://api.pro.coinbase.com/products/{product_id}/ticker"

headers = {
    'CB-VERSION': '2018-03-22',
    'CB-ACCESS-KEY': api_key,
    'CB-ACCESS-SIGN': "YOUR_SIGNATURE" # 需要使用 API 密钥短语生成签名
}

response = requests.get(url, headers=headers)

if response.status_code == 200:
    data = response.json()
    price = data['price']
    print(f"BTC-USD 的当前价格为: {price}")
else:
    print(f"请求失败，状态码: {response.status_code}")

• 注意：** YOUR_SIGNATURE 需要使用 HMAC-SHA256 算法根据 API 密钥短语、时间戳和请求路径生成。 API 签名 这涉及到对请求进行安全签名，以防止未经授权的访问。

4.2 下单 (限价单)

import requests
import time

api_key = "YOUR_API_KEY"
api_secret = "YOUR_API_SECRET"
product_id = "BTC-USD"
side = "buy" # 或者 "sell"
amount = 0.01 # 购买数量
price = 30000 # 限价

timestamp = str(int(time.time()))
message = f"{timestamp}{product_id}-{side}-limit-{amount}-{price}"
signature = hmac.new(api_secret.encode('utf-8'), message.encode('utf-8'), hashlib.sha256).hexdigest()

url = "https://api.pro.coinbase.com/orders"

headers = {
    'CB-VERSION': '2018-03-22',
    'CB-ACCESS-KEY': api_key,
    'CB-ACCESS-SIGN': signature,
    'Content-Type': 'application/json'
}

data = {
    "product_id": product_id,
    "side": side,
    "type": "limit",
    "amount": amount,
    "price": price
}

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

if response.status_code == 200:
    order_data = response.json()
    print(f"订单已提交，订单 ID: {order_data['id']}")
else:
    print(f"下单失败，状态码: {response.status_code}")
    print(response.text)

• 重要提示：** 请根据实际情况修改 API 密钥、产品 ID、交易方向、数量和价格。 务必理解下单风险，并做好风险管理。 风险管理

4.3 获取账户余额

import requests

api_key = "YOUR_API_KEY"
api_secret = "YOUR_API_SECRET"

url = "https://api.pro.coinbase.com/accounts"

headers = {
    'CB-VERSION': '2018-03-22',
    'CB-ACCESS-KEY': api_key,
    'CB-ACCESS-SIGN': "YOUR_SIGNATURE" # 需要使用 API 密钥短语生成签名
}

response = requests.get(url, headers=headers)

if response.status_code == 200:
    accounts = response.json()
    for account in accounts:
        print(f"账户 ID: {account['id']}, 币种: {account['currency']}, 可用余额: {account['available']}")
else:
    print(f"获取账户信息失败，状态码: {response.status_code}")

5. 最佳实践

• 安全第一： 始终安全地存储 API 密钥，并定期轮换密钥。
• 速率限制： Coinbase Pro API 具有速率限制，以防止滥用。 了解并遵守速率限制，以避免被封禁。 API 速率限制
• 错误处理： 编写代码以处理 API 错误，并适当地记录和报告错误。
• 数据验证： 验证从 API 返回的数据，以确保其准确性和完整性。
• 回测： 在实际交易之前，使用历史数据回测您的交易策略。 回测
• 监控： 监控 API 的性能和错误，并及时解决问题。
• 使用库： 考虑使用专门的 Coinbase Pro API 库，例如 cbpro (Python) 或 node-coinbase-pro (Node.js)，以简化开发过程。
• 了解市场： 在进行任何交易之前，充分了解您所交易的加密货币和市场。 市场分析
• 资金管理： 始终进行适当的资金管理，以限制您的损失。 资金管理策略

6. 进阶主题

• WebSockets： 使用 WebSockets 实时接收市场数据。 WebSocket API
• OAuth 2.0： 使用 OAuth 2.0 授权用户代表您访问 Coinbase Pro API。
• 高级订单类型： 探索各种高级订单类型，例如止损单、止盈单和追踪止损单。 高级订单类型
• 算法交易： 开发复杂的算法交易策略。 算法交易
• 量化交易： 结合技术分析、统计建模和自动化执行进行量化交易。 量化交易策略
• 高频交易： 理解高频交易的挑战和机遇（需要极高的技术水平和基础设施）。 高频交易
• 套利交易： 利用不同交易所的价格差异进行套利交易。 套利交易

7. 资源链接

• Coinbase Advanced Trade API Documentation
• Coinbase Developer Portal
• cbpro Python 库
• node-coinbase-pro Node.js 库
• 加密货币技术分析
• 加密货币量化交易

希望本指南能帮助您开始使用 Coinbase Pro API。 请记住，API 是一个强大的工具，但它需要仔细的规划、开发和测试。 祝您交易顺利！

推荐的期货交易平台

加入社区

关注 Telegram 频道 @strategybin 获取更多信息。 最佳盈利平台 – 立即注册.

参与我们的社区

关注 Telegram 频道 @Crypto_futurestrading 获取分析、免费信号等更多信息！