如何使用Coinbase高级交易API？ （机器人开发）

身份验证和 API 密钥设置

1. 导航至 Coinbase Advanced Trade 仪表板，然后选择用户菜单下的API 设置。

2. 单击“创建 API 密钥” ，仔细选择权限 -交易、查看和传输范围对于机器人功能至关重要。

3. 分配描述性名称，限制 IP 地址（如果从固定服务器运行），然后确认创建。

4. 将 API 密钥、机密和密码存储在加密的环境变量系统中，切勿将它们硬编码到源文件中。

5. 通过使用 HTTP 方法、请求路径和正文构造带时间戳的消息，然后使用密钥使用 HMAC-SHA256 对其进行签名，来验证签名生成。

订单生命周期管理

1. 通过POST /api/v3/brokerage/orders提交限价订单，指定product_id（例如BTC-USD）、side（买/卖）、client_order_id 和尺寸。

2. 使用 GTC 或 GTT 等time_in_force值来控制订单持续时间；机器人通常依赖具有 60 秒有效期的 GTT 来避免陈旧的展示位置。

3. 使用DELETE /api/v3/brokerage/orders/{order_id}取消挂单，或使用带过滤器的DELETE /api/v3/brokerage/orders批量取消。

4. 使用分页轮询GET /api/v3/brokerage/orders/historical，以根据本地状态协调已执行的填充。

5. 严格解析状态字段： open 、 done 、 rejected和pending在执行逻辑中需要不同的处理路径。

实时市场数据整合

1. 连接到wss://ws-feed.exchange.coinbase.com上的 WebSocket feed，订阅level2或股票频道以获取实时出价/要价更新。

2. 发送一条 JSON 订阅消息，其中包含从用于 REST 调用的相同凭证派生的product_ids 、 channels和签名。

3. 维护每个通道的序列号以检测丢失的消息 - 如果间隙超出容忍阈值，则丢弃并重新订阅。

4. 在计算价差、深度或波动率指标之前，将传入的价格和规模字段标准化为小数类型。

5. 使用心跳消息验证连接活跃度，并在间隔超过 30 秒时触发重连逻辑。

错误处理和速率限制

1. 检查 HTTP 状态代码： 429信号速率限制耗尽 - 尊重Retry-After标头并实施指数退避。

2、将401视为凭证失效；如果在没有本地更改的情况下重复，则旋转密钥。

3. 将400响应映射到特定验证失败（缺少字段、无效的product_id 或格式错误的时间戳）并记录准确的错误代码，例如invalid_client_order_id 。

4. 将500 系列错误捕获为暂时性基础设施问题；将失败的请求排队以便稍后使用幂等性密钥重放。

5. 记录X-Request-ID标头中返回的所有请求 ID，以便在事件解决期间将日志与 Coinbase 支持票证相关联。

常见问题解答

问：我可以在沙箱和生产环境中使用相同的 API 密钥吗？不需要。沙盒和生产需要单独创建 API 密钥，每个密钥都有自己的基本 URL、凭据和权限范围。

问：Coinbase Advanced Trade 是否支持通过 API 进行止损限价订单？是的。在订单负载中使用stop和stop_price参数，并将order_type设置为stop_limit 。

问：如何验证我的机器人签名是否符合 Coinbase 的预期？逐步重现签名：连接时间戳 + 方法 + request_path + 正文，然后使用经过 Base64 解码的密钥计算 HMAC-SHA256。将输出与CB-ACCESS-SIGN标头值进行比较。

问：轮询历史订单端点的频率是否有限制？是的。 /historic端点​​比标准订单端点执行更严格的速率限制 — 通常每个 API 密钥每分钟 30 个请求。