速率限制

RESTful 速率限制

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

1.資源池：

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

等級	统一账户	幣幣（包括杠杆）	合約	管理	賺取	跟單交易	公眾
VIP0	2000/30s	4000/30s	2000/30s	2000/30s	2000/30s	2000/30s	2000/30s
VIP1	2000/30s	6000/30s	2000/30s	2000/30s	2000/30s	2000/30s	2000/30s
VIP2	4000/30s	8000/30s	4000/30s	4000/30s	2000/30s	2000/30s	2000/30s
VIP3	5000/30s	10000/30s	5000/30s	5000/30s	2000/30s	2000/30s	2000/30s
VIP4	6000/30s	13000/30s	6000/30s	6000/30s	2000/30s	2000/30s	2000/30s
VIP5	7000/30s	16000/30s	7000/30s	7000/30s	2000/30s	2000/30s	2000/30s
VIP6	8000/30s	20000/30s	8000/30s	8000/30s	2000/30s	2000/30s	2000/30s
VIP7	10000/30s	23000/30s	10000/30s	10000/30s	2000/30s	2000/30s	2000/30s
VIP8	12000/30s	26000/30s	12000/30s	12000/30s	2000/30s	2000/30s	2000/30s
VIP9	14000/30s	30000/30s	14000/30s	14000/30s	2000/30s	2000/30s	2000/30s
VIP10	16000/30s	33000/30s	16000/30s	16000/30s	2000/30s	2000/30s	2000/30s
VIP11	18000/30s	36000/30s	18000/30s	18000/30s	2000/30s	2000/30s	2000/30s
VIP12	20000/30s	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. 最大連線數量

经典账户

限制：≤ 800 個並發連接

限制維度：私有（需認證）接口按 UID 計算；公有（無需認證）按 IP 計算

備註：母帳號與子帳號完全獨立（UID 不同）

统一账户：

限制：≤ 256 個並發連接/IP

2. 連線建立頻率

经典账户

限制：每分鐘 30 個新連線

限制維度：按單個連線計算（不按 UID 或 IP 合併計算）

3. 發送信息(客戶端 → 伺服器)

经典账户

限制：每 10 秒 100 條訊息

限制維度：按單個連線計算

4. 訂閱/取消訂閱請求

经典账户

單次請求最大主題數：100 個

限制維度：按單個連線計算

5. 單個連線最大訂閱主題數

经典账户

現貨 / 槓桿：≤ 400 個主題

合約：無限制

6. 公共行情頻道

经典账户

所有速率限制：按 IP 地址計算（不按 UID）

RESTful 速率限制#

1.資源池：#

2.權重：#

3.請求標題：#

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

5.私有接口速率限制#

Websocket 速率限制#

1. 最大連線數量#

2. 連線建立頻率#

3. 發送信息(客戶端 → 伺服器)#

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

5. 單個連線最大訂閱主題數#

6. 公共行情頻道#

RESTful 速率限制

1.資源池：

2.權重：

3.請求標題：

4.公共接口速率限制：

5.私有接口速率限制

Websocket 速率限制

1. 最大連線數量

2. 連線建立頻率

3. 發送信息(客戶端 → 伺服器)

4. 訂閱/取消訂閱請求

5. 單個連線最大訂閱主題數

6. 公共行情頻道