如何使用Coinbase API进行交易合同？

Coinbase Advanced Trade API仅支持现货交易（购买和出售实际加密），而不是期货或永久合同。

2025/08/12 17:14

了解Coinbase API及其功能

Coinbase API是一种强大的工具，可允许开发人员和交易者与Coinbase的金融服务进行程序互动。尽管Coinbase提供了广泛的功能，包括现货交易，钱包管理和价格数据检索，但至关重要的是要澄清Coinbase目前不支持通过其标准API来支持交易期货或永久合同。 Coinbase Advanced Trade API的主要重点是现货交易，这意味着以当前市场价格购买和销售实际的加密货币。

尽管如此，许多用户还是将Coinbase与Coinbase衍生品或Coinbase International Exchange混淆，这些衍生物是提供期货交易的独立实体。这些平台在不同的监管框架和API下运行。如果您的目标是交易期货或期权等合同，则必须确认您是否正在使用正确的Coinbase附属服务。目前， Coinbase Advanced Trade API仅支持现货市场运营，包括限额订单，市场订单和加密货币对的停止订单。

要开始使用API，您必须首先在Coinbase Advanced Trade上创建一个帐户并生成API密钥。这些密钥将授予您对交易帐户的申请访问，因此必须仔细管理权限至关重要。生成钥匙时，您可以分配特定的角色，例如“视图”，“交易”或“转移”。出于交易目的，请确保启用“交易”许可。

设置您的Coinbase API键

在进行任何交易之前，您需要使用API凭据来验证您的请求。这是生成和配置密钥的方法：

• 登录您的Coinbase Advanced Trade帐户
• 导航到设置> API
• 单击+新的API键
• 选择适当的权限： “查看”和“贸易”
• 输入您的密钥的名称（例如，“交易机器人”）
• 完整的两因素身份验证（2FA）
• 复制生成的API密钥，秘密和密码

安全存储这些凭证。秘密和密码仅显示一次，如果丢失，则无法检索。切勿在客户端代码或公共存储库中暴露它们。

一旦拥有钥匙，就可以开始将它们集成到应用程序中。 API使用HMAC-SHA256身份验证。每个请求必须包括以下标题：

• CB-ACCESS-KEY ：您的API密钥
• CB-ACCESS-SIGN ：消息的HMAC签名
• CB-ACCESS-TIMESTAMP ：请求的UNIX时间戳
• CB-ACCESS-PASSPHRASE ：您设置的密码

签名是通过使用您的秘密的时间戳，HTTP方法，请求路径和身体（如果有）的串联来生成的。

通过Coinbase API进行现货交易

尽管不支持合同交易，但您可以使用高级交易API执行现货交易。这些交易涉及以当前市场价格以当前市场价格交换加密货币。要下订单，您将使用“创建订单”端点。

这是为BTC-USD下达限额购买订单的一个示例：

• HTTP方法： POST
• 端点： https://api.coinbase.com/api/v3/brokerage/orders
• 请求主体：

   {
   'client_order_id': 'unique-id-123',
   'product_id': 'BTC-USD',
   'side': 'BUY',
   'order_configuration': {
   'limit_limit_gtc': { 'base_size': '0.001', 'limit_price': '30000.00'

  }
  }
  }

关键参数包括：

• client_order_id ：订单的唯一标识符
• product_id ：交易对（例如，btc-usd）
• side ： “买”或“卖”
• base_size ：交易的加密货币量
• limit_price ：您愿意支付的最高价格

确保您的帐户有足够的美元余额以购买或BTC余额进行卖出。根据市场可用性执行订单，可能部分填写。

要检查订单状态，请在响应中返回的order_id使用“获取订单”端点。您还可以使用具有状态过滤器的“列表订单”端点列出所有订单（打开，填充，取消）。

检索市场数据并监视价格

成功的交易需要最新的市场信息。 Coinbase API提供了几个端点来检索实时和历史数据。

要获取最新的最佳出价并要求产品价格：

• 端点： GET /api/v3/brokerage/product/book?product_id=BTC-USD&limit=1
• 响应包括：
  • 最高出价的price和size
  • 最高要求的price和size

对于烛台数据（用于技术分析），请使用：

• 端点： GET /api/v3/brokerage/market/products/BTC-USD/candles
• 查询参数： type=1_MINUTE ， start=1700000000 ， end=1700003600

这将返回指定时间范围和间隔的OHLC（开放，高，低，关闭）值。

您还可以通过多个级别检索订单书：

• limit=50给出了前50个出价和询问
• 使用此数据来分析市场深度并预测价格变动

定期轮询这些端点，您可以构建实时交易仪表板或自动化决策逻辑。

处理错误和费率限制

Coinbase API强加了速率限制以防止滥用。对于交易端点，限制通常为每秒10个API密钥的10请求。超过此结果导致429 Too Many Requests 。为了避免这种情况：

• 在您的重试逻辑中实现指数退回
• 尽可能缓存响应
• 使用Websocket进行实时数据而不是经常进行轮询

常见错误代码包括：

• 401 Unauthorized ：无效或缺少API凭据
• 403 Forbidden ：权限不足
• 404 Not Found ：无效的产品ID或订单ID
• 400 Bad Request ：畸形的JSON或无效参数

始终验证输入并优雅处理错误。例如，在下订单之前，请检查是否支持ETH-USD这样的产品ID。

常见问题

我可以使用API在Coinbase上交易期货吗？

不， Coinbase Advanced Trade API不支持期货或永久合同。仅限于现场交易。期货交易可在Coinbase衍生产品上使用，该衍生物可能具有单独的API接口。

Coinbase和Coinbase Advanced Trade API有什么区别？
Coinbase.com是一个面向消费者的平台，用于用菲亚特购买加密货币。 Advanced Trade API是用于自动交易的专业级界面，可为现货市场，订单书和定价数据提供程序化访问。

如何通过API取消打开订单？

使用DELETE /api/v3/brokerage/orders/{order_id} endpoint。将{order_id}替换为实际订单标识符。该响应确认如果已经填写或无效，则可以确认取消或返回错误。

使用API键进行自动交易安全吗？

是的，如果遵循最佳实践。使用强，独特的密码词，将权限限制在需要的内容中，将钥匙存储在加密环境中，并避免将它们在脚本中进行硬编码。考虑使用IP白名单（如果有）。