WEEX API 速率限制:請求權重與 429 錯誤
WEEX API 速率限制:請求權重與 429 錯誤
WEEX API 的速率限制取決於請求類型。REST API 使用以 IP 為基準的請求權重和以帳戶為基準的訂單額度,而 WebSocket 連線和訂閱也各有其限制。若要查詢適用於您整合方案的額度,請查看產品的 exchangeInfo、端點權重和回應標頭。如果收到 HTTP 429,請先暫停受影響的請求,再調整其發送頻率。
即使機器人自身的流量看起來不大,也可能觸及限制。市場資料服務、監控指令碼和其他策略可能共用其對外 IP。了解這項共用額度,比為每個程序各自設定獨立的每秒請求數更有幫助。
請求次數、權重和訂單限額有何不同?
| 請求類型 | 額度依據 | 實際影響 |
|---|---|---|
| 市場資料、帳戶查詢及其他非下單端點 | 對外 IP 的請求權重 | 共用該 IP 的應用程式需要協調流量。 |
| 下單 | 帳戶的 userId 和 ORDERS 額度 | 呼叫會消耗文件所列的訂單額度。這些下單請求不會消耗 IP 權重。 |
權重不只是呼叫次數的計數。權重為 10 的查詢會使用 10 個權重單位,而部分端點的權重會依請求參數而變動。因此,20 次呼叫所消耗的額度可能不同,取決於使用了哪些端點。
現貨單筆和批次下單會使用訂單額度。取消訂單和查詢訂單仍受 IP 限制。切換 API 金鑰不會讓同一個應用程式取得新的 IP 額度。
我可以在哪裡查看目前的額度?
現貨和期貨各有獨立的交易所資訊端點:
| 產品 | 查詢位址 |
|---|---|
| 現貨 | GET https://api-spot.weex.com/api/v3/exchangeInfo |
| 期貨 | GET https://api-contract.weex.com/capi/v3/market/exchangeInfo |
請在回應中找到 rateLimits,並一併查看其中四個欄位。rateLimitType 用來識別額度類型,interval 和 intervalNum 定義時間區間,而 limit 則表示該區間內的額度。
例如,在2026/11/04查詢的一份現貨回應中,REQUEST_WEIGHT 為每 10 秒 500,ORDERS 則為每 10 秒 100。前者代表權重單位,後者代表訂單額度。這些數值僅反映該現貨設定的快照。請勿將其套用至期貨,或在應用程式中視為永久不變的常數。
請查詢期貨端點以取得期貨限制。如果其回應與常見問題或端點參考文件不一致,請保留回應內容和查詢時間,以便 API 支援團隊在您變更正式環境流量前確認規則。
應用程式執行時,使用回應標頭追蹤用量
IP 回應會回報已使用和剩餘權重,分別使用 X-USED-WEIGHT-(intervalNum)(intervalLetter) 和 X-REMAINING-WEIGHT-(intervalNum)(intervalLetter)。例如,X-USED-WEIGHT-1M 表示目前 IP 在一分鐘區間內已使用的權重。
下單會使用 X-ORDER-COUNT-(intervalNum)(intervalLetter) 和 X-ORDER-REMAINING-(intervalNum)(intervalLetter)。請記錄實際回傳的區間名稱,以便判斷應用程式正在接近哪項限制。
若多項服務共用一個 IP 或帳戶,請考慮集中管理其額度。保留部分容量給訂單查詢、取消和復原作業,可讓這些操作在市場資料流量增加時仍有足夠空間。
收到 HTTP 429 時應如何恢復?
暫停觸及限制的請求佇列,並檢查回應標頭和時間區間。接著逐步增加重試延遲,並加入隨機抖動,避免工作程序同時恢復而立即再次觸及相同限制。請根據適用的時間區間選擇延遲,不要對所有請求都依賴同一個固定值。
接下來,追查流量來源。檢查是否有重複輪詢、不必要的完整資料查詢,或是共用 IP 卻分別追蹤額度的機器人。只降低一個程序的速度,可能無法減少整體流量。
官方存取限制說明指出,超過限制會回傳 429,持續違規則會遭到封禁 10 秒。封禁時間並不保證等待固定的 10 秒後就能恢復。如果下單請求也發生逾時或結果不明,請先查詢其狀態再重新送出,以免重複下單。
哪些 WebSocket 限制是獨立計算的?
現貨和期貨 WebSocket 文件列出以下限制:每個 IP 每五分鐘最多發起 300 次連線請求、每個 IP 最多建立 20 個並行連線、每個連線每小時最多執行 240 次訂閱操作,以及每個連線最多訂閱 100 個頻道。
這些限制衡量的是連線或訂閱活動,不代表伺服器每小時最多只能推送 240 則市場或訂單更新。重複使用連線、維護訂閱清單並處理心跳訊號,可以減少不必要的連線嘗試和訂閱。連線失敗後重新連線時,也請採用退避策略。
使用 CCXT 或 SDK 時,這些額度仍然重要,尤其是多個應用程式共用 IP 或帳戶的情況。如果觀察到的限制與預期不符,請使用官方 API 常見問題中的支援連結。請提供端點、時間戳記、狀態碼和已移除敏感資訊的回應標頭,以協助診斷問題。