速率限制

RESTful 速率限制

Rest 速率限制的具體規則如下：

1.資源池：

每個 API 資源池都有一定的配額，具體數量取決於 VIP 等級：

等級	统一账户	幣幣（包括杠杆）	合約	管理	賺取	跟單交易	公眾
VIP0	200/3s	4000/30s	2000/30s	2000/30s	2000/30s	2000/30s	2000/30s
VIP1	200/3s	6000/30s	2000/30s	2000/30s	2000/30s	2000/30s	2000/30s
VIP2	400/3s	8000/30s	4000/30s	4000/30s	2000/30s	2000/30s	2000/30s
VIP3	500/3s	10000/30s	5000/30s	5000/30s	2000/30s	2000/30s	2000/30s
VIP4	600/3s	13000/30s	6000/30s	6000/30s	2000/30s	2000/30s	2000/30s
VIP5	700/3s	16000/30s	7000/30s	7000/30s	2000/30s	2000/30s	2000/30s
VIP6	800/3s	20000/30s	8000/30s	8000/30s	2000/30s	2000/30s	2000/30s
VIP7	1000/3s	23000/30s	10000/30s	10000/30s	2000/30s	2000/30s	2000/30s
VIP8	1200/3s	26000/30s	12000/30s	12000/30s	2000/30s	2000/30s	2000/30s
VIP9	1400/3s	30000/30s	14000/30s	14000/30s	2000/30s	2000/30s	2000/30s
VIP10	1600/3s	33000/30s	16000/30s	16000/30s	2000/30s	2000/30s	2000/30s
VIP11	1800/3s	36000/30s	18000/30s	18000/30s	2000/30s	2000/30s	2000/30s
VIP12	2000/3s	40000/30s	20000/30s	20000/30s	2000/30s	2000/30s	2000/30s

2.權重：

當用戶請求任何 API 時，此界面的權重會每 30s (從用戶第一次請求的到達時間開始) 扣除並更新一次。有關各接口的具體速率限制權重，請參閱相關介面下的速率限制規定。

若在 30 秒內任何資源池的配額耗盡（即超過速率限制），就會傳回 http code:429, error code:429000 的錯誤代碼，並在回應標頭中顯示可再次發送請求的時間。用戶在此期間必須暫停存取，待資源配額重置後方可繼續。

例如：

當用戶的 VIP 為 5 時，他/她的「總幣幣數配額」為 16000/30s。

每個「新增幣幣限價單」的配額消耗量為 2。下第一張訂單後，用戶的剩餘幣幣配額為 15998，下第二張訂單後，剩餘配額為 15996，以此類推。

如果配額在 30 秒內未使用完畢，當下一個週期來臨時，即時資源池配額將被重設，並回到 16000 的配額限制。

3.請求標題：

每個請求傳回的資訊將包含下列資訊：總資源池配額、資源池剩餘配額、資源池配額重設倒數（毫秒）。

"gw-ratelimit-limit":500

"gw-ratelimit-remaining"：300

"gw-ratelimit-reset":1489

4.公共接口速率限制：

它是基於 IP 速率限制。若需大量使用公共接口，建議優先使用 WebSocket 接口（若該接口支援）以取代 REST 接口。為避免 IP 速率限制，您可採用以下方式：

使用一台伺服器綁定多個 IP 位址（IPv4 或 IPv6）。

使用不同的 IP 位址進行請求。

5.私有接口速率限制

除了公共資源池接口之外，其他資源池都是基於 UID ，API 回應標頭將包含資源池的速率限制資訊，例如：

剩餘速率限制次數。

速率限制週期時間。

在 API 請求層級，主帳戶與子帳戶的速率限制相互獨立。因此，若對某接口的存取需求較高，可透過子帳戶分散請求以提升限制配額。

伺服器超載限制
除常規速率限制外，伺服器超載可能觸發臨時速率限制。此時，系統將返回錯誤代碼 429000，但回應標頭不包含個人速率限制資訊。此類限制不計入常規速率限制配額。建議稍後重試。

申請更高限制
若您為專業交易者或做市商，需要更高的速率限制配額，請將以下資訊發送至 api@kucoin.com：

KuCoin 帳戶資訊

申請原因

預估交易量

WebSocket 限頻規則

1. 最大並發連線數

API	限制	統計維度	備註
Classic API	≤ 800 個並發連線	私有（需認證）接口按 UID 統計；公有（無需認證）接口按 IP 統計	主帳戶與子帳戶完全獨立（UID 不同）
Pro API	每個 IP：公有 ≤ 512 + 私有 ≤ 512（總計 1024）	按 IP 統計；公有與私有連線分開計算

2. 建立連線速率

API	限制	備註
Classic API	無限制
Pro API	每個 IP 每 5 分鐘最多建立 150 個新連線	若短時間內超限，伺服器可能拒絕新的連線請求。建議重複使用既有連線，避免頻繁斷開與重連。

3. 客戶端到服務端訊息（Client → Server）

API	限制	統計範圍 / 備註
Classic API	每 10 秒 100 條訊息	以單一連線計算
Pro API	每 10 秒 100 條訊息	以單一連線計算；包含 `subscribe`、`unsubscribe`、`ping`。透過 WebSocket 發送的撤單訊息不計入此限制。若超限，伺服器可能斷開該 WebSocket 連線。

4. 訂閱 / 取消訂閱請求

API	單次請求最大 Topics 數	統計範圍
Classic API	100	以單一連線計算
Pro API	無限制	不適用

5. 單一連線最大訂閱 Topics 數

API	產品線	限制	備註
Classic API	現貨 / 槓桿	≤ 400 個 topics
Classic API	合約	無限制
Pro API	全部	≤ 200 個 topics	若需更多 topics，請分散到多個連線中訂閱

6. 使用建議（Pro API）

盡可能重複使用既有 WebSocket 連線。

控制客戶端訊息發送頻率（每個連線每 10 秒不超過 100 條）。

當需訂閱大量 topics 時，請分散到多個連線中處理。

RESTful 速率限制#

1.資源池：#

2.權重：#

3.請求標題：#

4.公共接口速率限制：#

5.私有接口速率限制#

WebSocket 限頻規則#

1. 最大並發連線數#

2. 建立連線速率#

3. 客戶端到服務端訊息（Client → Server）#

4. 訂閱 / 取消訂閱請求#

5. 單一連線最大訂閱 Topics 數#

6. 使用建議（Pro API）#