如何使用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 支援票證相關聯。

常見問題解答

Q：我可以在沙箱和生產環境中使用相同的 API 金鑰嗎？不需要。沙盒和生產需要單獨建立 API 金鑰，每個金鑰都有自己的基本 URL、憑證和權限範圍。

Q：Coinbase Advanced Trade 是否支援透過 API 進行停損限價訂單？是的。在訂單負載中使用stop和stop_price參數，並將order_type設定為stop_limit 。

Q：如何驗證我的機器人簽名是否符合 Coinbase 的預期？逐步重現簽章：連線時間戳記 + 方法 + request_path + 正文，然後使用經過 Base64 解碼的金鑰計算 HMAC-SHA256。將輸出與CB-ACCESS-SIGN標頭值進行比較。

Q：輪詢歷史訂單端點的頻率是否有限制？是的。 /historic端點比標準訂單端點執行更嚴格的速率限制 — 通常每個 API 金鑰每分鐘 30 個請求。