Coinbase期貨市場的API利率限制是多少？

Coinbase Futures API強制執行速率限制：公共端點的每個IP 3 req/sec，私有API密鑰10個REQ/SEC；使用Websockets和緩存進行優化。

2025/08/11 20:29

了解Coinbase Futures的API率限制

當通過其API與Coinbase Futures市場互動時，開發人員必須遵守旨在維持系統穩定性和公平用法的特定速率限制。這些限制控制用戶可以在給定的時間窗口內提出多少要求。超過這些閾值可能會導致臨時的HTTP 429響應太多，從而停止訪問，直到速率限制窗口重置為止。確切的限制取決於端點，身份驗證方法的類型以及請求是公共還是私人。

對於支持期貨交易的Coinbase Advanced Trade API ，利率限制將以每端的基礎應用。與涉及諸如下訂單或支票餘額之類的私人端點相比，公共終點（例如獲取訂單賬簿或股票價格）的市場數據（例如訂單書或股票價格）通常允許更高的請求量。未經身份驗證時，這些公共端點通常限於每秒3個請求。這意味著如果沒有API密鑰，您的訪問就會限制在所有公共未來數據終點的該閾值中。

身份驗證的端點速率限制

使用API密鑰和秘密來驗證請求時，速率限制與用戶帳戶而不是IP地址相關。這允許更加一致和更高的吞吐量，尤其是對於依靠自動化系統的交易者而言。對於私人端點上的經過驗證的請求，例如提交期貨訂單，取消訂單或檢索職位信息- 費率限制約為每個API密鑰每秒10個請求。對於必須仔細管理請求頻率以避免限制的算法交易者，此限制至關重要。

必須注意的是，超過速率限制會導致臨時塊，通常持續幾分鐘。為了防止這種情況，開發人員應實施指數向後策略，並監視API返回的HTTP響應標頭。關鍵標題包括：

• cb-after-rate-limit-reset ：指示秒數直到速率限制重置為止。
• cb-after-rate-limit-remaining ：顯示當前窗口中保留多少個請求。
• cb-after-rate-limit-cap ：指定每個窗口允許的請求總數。

監視這些標頭可以實時調整請求起搏，以確保遵守Coinbase的費率控制政策。

區分公共和私人終點

Coinbase Futures API區分公共數據訪問，每個訪問都有單獨的費率限制。公共終點包括：

• get/api/v3/brokerage/market/產品- 檢索可用的期貨合約。
• get/api/v3/brokerage/market/product_book - 獲取訂單訂單數據。
• get/api/v3/經紀/市場/蠟燭- 返回曆史價格蠟燭。

如果未經身份驗證，這些端點是每秒3個請求的速率限制。經過身份驗證時，它們可能會受益於更寬敞的處理，但身份驗證的主要優點在於訪問私人端點。

需要有效API憑據的私人端點包括：

• POST/API/V3/經紀/訂單- 下達新的期貨訂單。
• 刪除/api/v3/brokerage/orders/{order_id} - 取消現有訂單。
• get/api/v3/brokerage/職位- 檢索當前的開放位置。
• get/api/v3/經紀/帳戶- 列出交易帳戶。

這些僅限於每秒10個API密鑰的10個請求，並且持續的爆發可能會觸發暫時的懸架。開發人員應設計其應用程序以排隊和節氣門請求，以保持在這些範圍內。

在實踐中管理利率限制

要在Coinbase的速率限制框架內有效運行，開發人員應實施強大的請求管理。一種有效的方法是使用代幣的桶算法，其中每個API請求都消耗一個令牌，並以固定的速率補充令牌。這樣可以確保請求適當分佈。

另一個實用的步驟是在可能的情況下在本地緩存公共數據。例如，與其重複調用產品列表端點，不如存儲合同規格並每隔幾分鐘刷新它們。這減少了不必要的API呼叫，並有助於保留關鍵操作（例如訂單執行）的費率限制預算。

構建自動交易系統時，請考慮：

• 在受支持的情況下，將相關查詢分解為單個請求。
• 使用Websocket Feed進行實時市場數據，而不是輪詢休息端點。
• 根據cb-after-rate-limit-reset標頭實現重試邏輯，並通過延遲。

Websocket連接（例如Coinbase Advanced Trade Websocket Feed ）提供了一種更有效的方法，可以在不消耗REST API率限制的情況下接收有關訂單簿，交易和帳戶更改的實時更新。訂閱諸如level2 ， matches或user類的頻道允許以最小開銷的連續數據流。

API密鑰配置的最佳實踐

為了最大化可靠性和安全性，請使用最小所需的權限配置API密鑰。對於期貨交易，僅限於交易的關鍵和查看範圍，避免授予退出或轉移許可。在妥協的情況下，這會降低風險。

使用環境變量或Secrets Manager安全地存儲API秘密和密碼。從源文件中切勿硬碼憑據。提出請求時，請確保所有標題正確格式化：

• CB-ACCESS-KEY ：您的API密鑰。
• CB-ACCESS-SIGN ：HMAC-SHA256消息的簽名。
• CB-ACCESS-TIMESTAMP ：請求的UNIX時間戳。
• CB-ACCESS-PASSPHRASE ：創建密鑰時使用的密碼。

每個請求主體必須序列化並正確簽名。例如，在訂購期貨訂單時，消息字符串應包括時間戳，HTTP方法，請求路徑和身體（如果存在），所有這些都與API Secret進行了串聯並與Hashsheed。

常見問題

我可以增加對Coinbase Futures的API利率限制嗎？

不，速率限制是每個API密鑰固定的，不能通過帳戶升級或支持請求增加。預計大批交易者將優化其請求模式，而不是尋求更高的限制。

Websocket連接是否計入REST API速率限制？

不， Websocket訂閱不會消耗靜止率限制。它們在單獨的渠道上運行，是接收實時市場數據的首選方法，而不會影響您的請求配額。

如果我超過費率限制會發生什麼？

您將收到HTTP 429的響應，進一步的請求將在短時間內被阻止 - 通常在60秒鐘以下。用指數向後實現重試邏輯，以優雅地處理此問題。

來自同一帳戶的多個API鍵共享費率限制嗎？

不，每個API密鑰都有自己的獨立利率限制。創建多個鍵允許並行訪問，但是每個鍵仍以每秒10個請求的限制，用於私人端點。