Coinbase API自动交易设置：Python教程

时间：2025-02-27 13:45:54 目录：教程阅读：48

Coinbase API 自动交易设置详细教程

准备工作

在开始之前，你需要准备以下事项，这些准备工作是成功对接 Coinbase API 并进行加密货币交易的基础。

一个 Coinbase 账户（已完成 KYC 认证） ：你需要一个有效的 Coinbase 账户才能使用其 API。确保你的账户已经完成了 KYC（了解你的客户）认证，这是为了符合监管要求并确保交易安全。根据Coinbase的使用条款，不同地区的KYC要求可能有所不同。请前往Coinbase官方网站按照提示完成实名认证。
一台电脑或服务器 ：你需要一台能够运行代码的电脑或服务器。服务器的优势在于可以24/7不间断地运行交易机器人，但电脑也足够用于测试和学习。选择哪种取决于你的交易策略和需求。服务器可以选择云服务器，例如Amazon AWS，Google Cloud或阿里云等。
基本的编程知识 (Python 是一个不错的选择，本教程示例代码基于 Python) ：掌握至少一种编程语言是至关重要的。Python 因其简洁的语法和丰富的库支持，非常适合用于加密货币交易。当然，你也可以选择其他你熟悉的编程语言，例如JavaScript, Java, C++等。重要的是理解API的调用方式和数据处理。
安装 Python 以及必要的库 (如 requests ， cbpro ) ：安装 Python 是使用 Python 进行编程的前提。 requests 库用于发送 HTTP 请求， cbpro 是一个专门为 Coinbase Pro API 提供的 Python 封装库，简化了 API 的调用过程。通过 pip 安装这些库：
```
pip install requests cbpro
```
除了requests和cbpro，可能还需要其他库，比如用于数据分析的pandas，numpy，用于绘图的matplotlib，用于科学计算的scipy，以及用于数据持久化的数据库驱动，例如psycopg2 (PostgreSQL) 或 pymysql (MySQL)。请根据你的具体需求安装相应的库。请务必确保安装的是最新版本。

步骤 1：生成 Coinbase API 密钥

登录你的 Coinbase 账户。这是进行 API 密钥创建和管理的第一步。请确保使用双重验证(2FA)来提高账户安全性。
访问 Coinbase API 页面。具体的访问路径可能因 Coinbase 账户类型（例如个人账户或机构账户）和界面版本而异。通常，可以在“设置”、“安全”或“开发者”选项中找到 API 管理入口。仔细查找相关的选项，如"API访问"，"API密钥"或"开发者工具"。
创建一个新的 API 密钥。创建API密钥时，系统会要求你定义密钥的权限范围。为了实现自动交易，必须谨慎地授予 trade 权限，这将允许你的应用程序代表你执行买卖操作。同时，你可能还需要授予 wallet:accounts:read 权限来读取账户余额和交易历史，以便程序能做出明智的交易决策。理解每个权限的含义至关重要，避免授予超出必要的权限，降低潜在的安全风险。还可以设置API密钥的访问IP白名单，限制只有特定IP地址的服务器才能使用该密钥，进一步增强安全性。
务必妥善保管你的 API 密钥和密钥密码 (passphrase)！ 它们是访问你 Coinbase 账户的唯一凭证。API 密钥泄露可能导致账户资金损失。请采取以下措施保护密钥：
- 不要将 API 密钥硬编码到应用程序中。
- 使用环境变量或安全的密钥管理服务来存储密钥。
- 定期轮换 API 密钥。
- 不要在公共代码仓库（如 GitHub）中提交包含 API 密钥的代码。
- 启用IP限制，仅允许来自受信任IP地址的访问。
密钥密码（Passphrase）是加密 API 密钥的额外安全层，同样需要安全保存。如果忘记 Passphrase，可能需要重新生成 API 密钥。

步骤 2：安装必要的 Python 库

打开你的命令行终端（如 macOS 和 Linux 上的 Terminal）或 PowerShell（Windows 上），使用 pip（Python 的包管理器）安装 cbpro 库。 cbpro 是一个专门为 Coinbase Pro API 交互设计的 Python 库，它封装了复杂的 API 调用，提供了简洁易用的函数和类，极大地简化了与 Coinbase Pro 交易所的数据交互和交易操作。通过 cbpro ，你可以轻松地获取市场数据、提交订单、管理账户信息等。

bash

pip install cbpro

如果你遇到网络连接问题，或者希望加速下载过程，可以考虑使用国内的镜像源。清华大学提供的镜像源（https://pypi.tuna.tsinghua.edu.cn/simple）是一个常用的选择，能显著提高下载速度，特别是在国内网络环境下。

bash

pip install -i https://pypi.tuna.tsinghua.edu.cn/simple cbpro

虽然 cbpro 库通常会自动处理 HTTP 请求，但在某些情况下，显式安装 requests 库可能仍然是必要的。 requests 是一个流行的 Python HTTP 库，提供了强大的功能，用于发送 HTTP/1.1 请求，包括 GET、POST、PUT、DELETE 等，并处理服务器的响应。安装它可以确保你的程序在处理 API 调用时具有更好的兼容性和稳定性。

bash

pip install requests

步骤 3：编写 Python 脚本

创建一个新的 Python 文件，例如 coinbase_auto_trader.py ，用于实现自动交易逻辑。此脚本将使用 Coinbase Pro API 与交易所进行交互，因此需要安装相应的 Python 库。确保你的开发环境已安装 Python 和 pip 包管理器。

使用 pip 安装 cbpro 库，它是 Coinbase Pro 官方提供的 Python 客户端库，方便与 API 进行交互。可以使用以下命令安装： pip install cbpro 。安装完毕后，可以在 Python 脚本中导入该库。

接下来，编写以下 Python 代码，导入必要的库：

import cbpro
import time

cbpro 库提供了访问 Coinbase Pro API 的各种功能，包括获取市场数据、下单、查询账户信息等。 time 库用于控制脚本的执行节奏，例如设置轮询间隔，避免过于频繁地访问 API。

为了安全地使用 Coinbase Pro API，你需要创建 API 密钥对。进入你的 Coinbase Pro 账户，在 API 设置中生成密钥，并妥善保管。千万不要将 API 密钥泄露给他人，也不要将其硬编码到脚本中。推荐使用环境变量或配置文件来存储 API 密钥。

你的 API 密钥、密钥密码和账户 ID

为了安全地与交易所或加密货币服务平台交互，你需要一组关键凭证。这些凭证包括 API 密钥（API Key）、密钥密码（Passphrase）和账户 ID（Account ID）。请务必妥善保管这些信息，切勿泄露给他人。

API 密钥 ( API_KEY ) 和 API 密钥密码 ( API_SECRET ) 共同构成你的身份验证信息，它们允许你的应用程序代表你访问你的账户并执行操作。 API 密钥类似于用户名，而 API 密钥密码则类似于密码。这两者必须正确匹配，才能成功进行身份验证。

密钥密码 ( PASSPHRASE ) 是可选的，但强烈建议设置。它作为额外的安全层，用于加密你的 API 密钥。即使 API 密钥泄露，攻击者也无法直接使用它，除非他们也知道密钥密码。将密钥密码视为保护你的 API 密钥的保险措施。

账户 ID ( ACCOUNT_ID ) 用于识别你在特定交易所或平台上的账户。虽然并非所有 API 调用都强制要求账户 ID，但它对于查询账户余额、交易历史记录以及执行与特定账户相关的操作至关重要。强烈建议提供账户 ID，以便充分利用 API 的功能。

请将以下变量替换为你自己的凭证：

API_KEY = 'YOUR_API_KEY'
API_SECRET = 'YOUR_API_SECRET'
PASSPHRASE  = 'YOUR_PASSPHRASE'
ACCOUNT_ID  = 'YOUR_ACCOUNT_ID'  #用于查询账户余额，并非必需，但强烈建议

重要提示：

务必将你的 API 密钥、密钥密码和账户 ID 保存在安全的地方。
不要将这些凭证存储在代码库中，特别是公开的代码库（如 GitHub）。
考虑使用环境变量或密钥管理系统来安全地存储这些敏感信息。
定期轮换你的 API 密钥和密钥密码，以降低风险。
启用双因素身份验证 (2FA) 可以为你的账户增加额外的安全层。

Coinbase Pro API 接口地址

Coinbase Pro API 的基础 URL 地址为： https://api.pro.coinbase.com 。所有 API 请求都以此地址为起点构建。请注意，Coinbase Pro 已经更名为 Coinbase Advanced Trade，API 的底层逻辑和接口地址仍然有效。

在使用 API 时，请确保你的请求头包含了必要的身份验证信息，例如 API 密钥、密钥签名和时间戳。这些信息用于验证你的身份并确保请求的安全性。

务必查阅 Coinbase 官方的 API 文档，以获取关于可用端点、请求参数、响应格式以及速率限制的详细信息。正确理解并遵守速率限制对于避免 API 访问受阻至关重要。文档地址请参考Coinbase官方网站的开发者部分。

请注意，Coinbase 可能会更新 API 的接口地址或版本。建议定期检查官方文档，以确保你的应用程序与最新的 API 保持兼容性。例如，未来可能存在api.advancedtrade.coinbase.com的地址。

在使用API获取实时市场数据和交易数据时，可以考虑使用WebSocket连接以获取更低的延迟和实时更新。相比于轮询REST API，WebSocket提供了更高效的数据推送机制。

创建认证对象

为了与Coinbase Pro API进行安全交互，需要创建一个认证客户端对象。这个对象将使用你的API密钥、密钥和密码短语进行初始化。请务必妥善保管这些凭据，切勿泄露给他人。 API_KEY 是你的API密钥， API_SECRET 是你的API密钥， PASSPHRASE 是创建API密钥时设置的密码短语， API_URL 是Coinbase Pro API的URL，通常是 https://api.pro.coinbase.com 。

auth_client = cbpro.AuthenticatedClient(API_KEY, API_SECRET, PASSPHRASE, api_url=API_URL)

以下函数用于检索指定加密货币账户的可用余额。它通过循环遍历所有账户，找到与指定币种匹配的账户，并返回其可用余额。如果找不到匹配的币种，则返回 None 。

def get_account_balance(currency):

"""

获取指定币种的账户余额

"""

accounts = auth_client.get_accounts()

for account in accounts:

if account['currency'] == currency:

return float(account['available'])

return None

以下函数用于下达市价单。市价单会立即以当前市场价格执行。 product_id 参数指定要交易的交易对，例如 'BTC-USD' 表示比特币/美元。 side 参数指定是买入还是卖出，取值为 'buy' 或 'sell' 。 size 参数指定要交易的数量。此函数包含一个异常处理块，用于捕获下单过程中可能发生的任何错误，并打印错误消息。返回值为订单详情，失败时返回 None 。

def place_market_order(product_id, side, size):

"""

下市价单

product_id: 交易对 (例如 'BTC-USD')

side: 'buy' 或 'sell'

size: 交易数量

"""

try:

order = auth_client.place_market_order(product_id, side, size)

print(f"市价单已提交：{order}")

return order

except Exception as e:

print(f"下单失败：{e}")

return None

以下函数用于获取指定交易对的最新交易信息，包括当前价格。它使用 get_product_ticker 方法从Coinbase Pro API检索ticker信息。此函数也包含一个异常处理块，用于捕获获取ticker信息时可能发生的任何错误，并打印错误消息。返回值为指定交易对的当前价格，失败时返回 None 。

def get_ticker(product_id):

"""

获取指定交易对的最新交易信息

"""

try:

ticker = auth_client.get_product_ticker(product_id=product_id)

return float(ticker['price'])

except Exception as e:

print(f"获取交易信息失败: {e}")

return None

设置交易参数

PRODUCT_ID = 'BTC-USD' 交易对：指定交易市场中交易的加密货币对，这里设定为比特币/美元（BTC-USD）。不同的交易平台可能会使用不同的代码来表示相同的交易对，例如Coinbase Pro 使用'BTC-USD'，而Binance可能使用'BTCUSDT'。选择合适的交易对取决于你的交易平台和你的交易策略。

TRADE_SIZE = 0.001 每次交易的比特币数量：代表每次买入或卖出的比特币数量。0.001 BTC意味着每次交易只交易极小一部分的比特币。这个数值的大小应该根据你的总资金、风险承受能力以及交易平台的最小交易单位来决定。较小的交易规模有助于降低单次交易的风险。

PROFIT_THRESHOLD = 0.01 盈利阈值：当交易盈利达到设定的盈利比例时，程序将自动执行卖出操作。这里设定为0.01，即1%的盈利。盈利阈值的设置至关重要，它直接影响你的交易频率和盈利潜力。过低的阈值可能导致频繁交易，增加交易成本；过高的阈值可能错失获利机会。可以结合历史数据和市场波动性来调整这个参数。该阈值指的是相对于购买价格的百分比涨幅。

交易逻辑

此交易逻辑描述了一个简单的加密货币自动交易机器人，该机器人使用美元购买和出售比特币（或其他指定的加密货币）。它在一个无限循环中运行，持续评估市场状况并根据预定义的参数执行交易。

while True: 循环确保机器人持续运行，除非手动停止。 try...except 块用于捕获可能发生的任何异常，例如网络问题、API 错误或意外的市场波动，以防止机器人崩溃。发生异常时，将打印错误消息，机器人会休眠 60 秒，然后再重试。

循环内部执行以下步骤：

获取当前比特币价格：

current_price = get_ticker(PRODUCT_ID) 函数调用从交易所的 API 获取指定交易对（例如 BTC-USD）的当前市场价格。 PRODUCT_ID 是一个配置变量，定义了要交易的加密货币对。如果无法获取价格（例如，由于 API 错误），机器人会休眠 60 秒，然后再重试。这确保了在发生临时问题时，机器人不会尝试使用陈旧或不准确的数据进行交易。
```
print(f"当前 {PRODUCT_ID} 价格：{current_price}")
```
查询账户美元余额：

usd_balance = get_account_balance('USD') 函数调用从交易账户获取可用的美元余额。这对于确定是否有足够的资金购买比特币至关重要。与获取价格类似，如果无法检索余额（例如，由于身份验证问题），机器人会休眠 60 秒，然后重试。
```
print("无法获取美元余额，请检查账户ID和API权限")
```
```
print(f"可用美元余额: {usd_balance}")
```
买入比特币（如果满足条件）：

if usd_balance > (current_price * TRADE_SIZE * 1.01): 语句检查美元余额是否足以购买指定数量的比特币。 TRADE_SIZE 是一个配置变量，定义了每次购买或出售的比特币数量。乘以 1.01 是为了预留 1% 的交易手续费。这有助于确保机器人不会试图花费超过其拥有的金额。

如果余额充足，则使用 place_market_order(PRODUCT_ID, 'buy', TRADE_SIZE) 函数提交市价买单。市价单意味着订单将以可用的最佳价格立即执行。然后检查订单的状态。如果订单成功完成（ order['status'] == 'done' ），则根据订单的成交数据计算实际买入均价。这通过将 fill_fees （支付的费用）除以 executed_value （购买的总价值）来完成。 buy_price 用于后续计算盈利能力。
```
print("满足买入条件，正在买入...")
```
```
order = place_market_order(PRODUCT_ID, 'buy', TRADE_SIZE)
```
```
buy_price = float(order['fill_fees']) / float(order['executed_value'])
```
```
print(f"成功买入 {TRADE_SIZE} {PRODUCT_ID.split('-')[0]}，买入均价: {buy_price}")
```
监控价格并卖出（如果达到盈利阈值）：

如果成功购买了比特币，机器人将进入一个内部 while True 循环，该循环监控价格以确定何时出售。该循环不断获取当前价格并计算盈利比例： profit = (current_price - buy_price) / buy_price 。 PROFIT_THRESHOLD 是一个配置变量，定义了出售比特币所需的最小盈利比例。如果盈利比例超过或等于阈值，则使用 place_market_order(PRODUCT_ID, 'sell', TRADE_SIZE) 函数提交市价卖单。如果卖单成功完成，则打印一条消息，表明已售出比特币，并且内部循环中断。
```
while True:
```
```
current_price = get_ticker(PRODUCT_ID)
```
```
profit = (current_price - buy_price) / buy_price
```
```
print(f"当前盈利比例: {profit:.4f}")
```
```
if profit >= PROFIT_THRESHOLD:
```
```
print("达到盈利阈值，正在卖出...")
```
```
sell_order = place_market_order(PRODUCT_ID, 'sell', TRADE_SIZE)
```
```
print(f"成功卖出 {TRADE_SIZE} {PRODUCT_ID.split('-')[0]}")
```
如果在达到盈利阈值之前，内部循环每 30 秒休眠一次，以避免过度 API 调用并减少资源消耗。
美元余额不足：

如果美元余额不足以购买比特币，则打印一条消息，表明资金不足。然后机器人休眠 60 秒，然后再重新检查条件。
```
else:
```
```
print("美元余额不足，无法买入。")
```

重要注意事项：

此交易逻辑是一个简化的示例，不应在没有进一步研究、测试和修改的情况下用于真实交易。
加密货币交易具有风险，并且可能会损失资金。
应仔细考虑配置变量（例如 TRADE_SIZE 和 PROFIT_THRESHOLD ），以适应个人的风险承受能力和交易目标。
建议使用止损单来限制潜在损失。
确保用于与交易所 API 交互的 API 密钥已安全存储并受到保护。
定期监控机器人的性能并根据需要调整参数。
考虑实施更复杂的交易策略，例如使用技术指标或订单簿分析。


except Exception as e:
    print(f"发生错误：{e}")
    time.sleep(60)

步骤 4：配置脚本

将 YOUR_API_KEY 、 YOUR_API_SECRET 和 YOUR_PASSPHRASE 替换为你从加密货币交易所获得的实际 API 密钥、API 密钥密码以及账户 ID。API 密钥用于验证你的身份并授权脚本代表你执行交易。确保妥善保管这些凭证，切勿泄露给他人，并定期轮换以提高安全性。密码保护的 API 密钥（PASSPHRASE）是可选的，但强烈建议启用，以增加额外的安全层。
根据你的交易策略和风险承受能力，精确修改 PRODUCT_ID 、 TRADE_SIZE 和 PROFIT_THRESHOLD 等参数。 PRODUCT_ID 定义了你要交易的加密货币交易对，例如 "BTC-USD"。 TRADE_SIZE 设定了每次交易的数量，务必根据你的账户规模和风险管理策略合理设置。 PROFIT_THRESHOLD 则决定了交易的盈利目标，用百分比或具体数值表示。审慎调整这些参数是优化交易表现的关键。
在部署脚本之前，务必仔细阅读并充分理解代码的每一行，深入了解其交易逻辑。重点关注订单类型（市价单、限价单等）、止损策略、以及错误处理机制。理解代码逻辑有助于你在出现意外情况时迅速做出反应，并有效排除潜在的故障。建议在模拟账户或测试环境中进行充分的测试，确保脚本按照预期运行，然后再将其应用于真实交易。

步骤 5：执行交易脚本

准备就绪后，即可在命令行终端或 PowerShell 中启动你的 Python 交易脚本。请确保你已正确安装所有依赖库，并配置了有效的 API 密钥和交易参数。

启动脚本时，系统将根据你的策略自动监控市场行情并执行买卖操作。请务必谨慎操作，并对脚本进行充分的测试和验证。

使用以下命令运行脚本：

bash
python coinbase_auto_trader.py

请将 coinbase_auto_trader.py 替换为你实际的脚本文件名。脚本运行后，你可以在终端查看实时的交易日志和状态更新。

高级用法

限价单: 限价单允许您以特定价格或更优价格买入或卖出加密货币。使用 auth_client.place_limit_order() 函数可以下达限价单。您需要指定期望的价格和数量。限价单只有在市场价格达到或超过您指定的价格时才会成交。这意味着您可以控制交易执行的价格，但订单不一定会立即执行。
止损单: 止损单是一种条件单，当市场价格达到预设的止损价格时，将触发一个市价单。使用 auth_client.place_stop_order() 函数下达止损单。止损单用于限制潜在的损失。然而，需要注意的是，当止损价格被触发时，订单将以当时的市价执行，最终成交价可能与止损价格略有偏差，尤其是在市场波动剧烈的情况下。
WebSocket: Coinbase Pro WebSocket API 提供了一个实时的、推送式的市场数据流，无需您不断地轮询 API。使用 cbpro 库提供的 WebSocket 客户端可以订阅各种市场数据，例如价格、成交量、订单簿更新等。利用 WebSocket API 可以极大地降低延迟，并快速响应市场变化，这对于高频交易和算法交易至关重要。相比轮询，WebSocket能显著减少服务器的资源消耗。
错误处理: 健壮的错误处理机制对于自动交易系统至关重要。使用 try...except 块捕获可能发生的异常，例如网络连接错误、API 速率限制、无效订单参数等。将捕获的异常信息记录到日志文件中，便于问题诊断和排查。可以根据不同的异常类型采取相应的处理措施，例如重试、暂停交易、发送警报等。详细的日志记录有助于监控系统的运行状况并及时发现潜在问题。
风控措施: 风险管理是加密货币交易中不可或缺的一部分。设置合理的止损点和盈利目标，可以帮助您控制风险并锁定利润。避免过度交易，不要追逐市场热点或听信谣言。制定交易计划并严格执行，不要被情绪左右。定期审查您的交易策略，并根据市场情况进行调整。严格的风险管理能够保护您的资金并提高长期盈利能力。
云服务器: 将交易脚本部署到云服务器上，可以实现 24/7 全天候自动交易。云服务器具有高可用性和稳定性，可以保证交易系统不间断运行。选择靠近交易所服务器的云服务器，可以降低网络延迟。需要确保云服务器的安全性，防止未经授权的访问。定期备份交易脚本和数据，防止数据丢失。通过云服务器，您可以构建一个可靠、高效的自动交易系统。