REST API

REST新版限頻2.0已上綫，相較於1.0，用戶可以根據策略，更加自由地突破單個接口的頻率限制，自由統籌接口使用，這使得過分依賴某些接口的策略能夠順利運行。 例如，在1.0限頻時，高頻用戶下單撤單接口限制較大，而在新的邏輯下，只要不過多請求其他接口，下單撤單可以是以前的2-3倍，因此可以實現更高頻的策略要求 即，新的限頻規則相當於將確定資源供給，根據用戶需求，自行實現接口的優化配置。

REST限頻2.0的具體規則如下：

• 資源池： 每一個api資源池會有一定的額度，具体额度多少取决于VIP等级：

公有限頻、現貨限頻(包含杠杆)、合約限頻、管理限頻

Level	Spot	Futures	ManageMent	Public
VIP0	4000/30s	2000/30s	2000/30s	2000/30s
VIP1	6000/30s	2000/30s	2000/30s	2000/30s
VIP2	8000/30s	4000/30s	4000/30s	2000/30s
VIP3	10000/30s	5000/30s	5000/30s	2000/30s
VIP4	13000/30s	6000/30s	6000/30s	2000/30s
VIP5	16000/30s	7000/30s	7000/30s	2000/30s
VIP6	20000/30s	8000/30s	8000/30s	2000/30s
VIP7	23000/30s	10000/30s	10000/30s	2000/30s
VIP8	26000/30s	12000/30s	12000/30s	2000/30s
VIP9	30000/30s	14000/30s	14000/30s	2000/30s
VIP10	33000/30s	16000/30s	16000/30s	2000/30s
VIP11	36000/30s	18000/30s	18000/30s	2000/30s
VIP12	40000/30s	20000/30s	20000/30s	2000/30s

• 權重： 用戶請求任何一個api，會在扣減此接口的權重，每30s更新一次（按用戶第一個請求到達時間開始計時），具體接口請參照每個接口下的限頻權重規定。

如果在30s內，任何一個資源池的額度用滿，即超出限頻後，返回消息為http code:429、error code:429000的報錯，並在請求頭顯示多長時間後可以重新請求。此時用戶需要停止訪問，等資源額度重置後才可以繼續訪問。

舉例説明：

用戶vip為5時，擁有16000/30s的下“縂現貨額度”。

現貨新增限價訂單的每次額度消耗為2，第一次下單后，該用戶所剩額度為15998，第二次下單后所剩額度為15996，以此類推。

如果在30秒内沒有使用完該額度。會在下一個周期到來時，重置現貨資源池額度，變回16000的額度上限。

• 請求頭： 每個請求的返回信息，會攜帶以下信息：資源池額度總數、資源池剩餘額度、資源池額度重置倒計時(毫秒)。格式如下：

"gw-ratelimit-limit": 500

"gw-ratelimit-remaining": 300

"gw-ratelimit-reset": 1489

• 公有限頻： 是基於ip限頻的。如果有很大的公有接口使用需求，建議使用Websocket接口代替rest接口(如果接口支持的話)。也可以用一臺服務器綁定多個ip地址（ipv4或者ipv6），或者使用不同的ip來規避ip限頻問題。

• 現貨限頻(包含杠杆)、合約限頻、管理限頻： 均是基於uid的，同時請求頭會攜帶該資源池的限頻信息，例如剩餘限頻次數，限頻週期時間等。並且子帳戶與母帳戶的限頻在api請求層面相互獨立，也就是說如果此類接口訪問量需求比較大，同樣可以通過使用子帳戶來解決

除常規限頻外，伺服器超載可能也會導致限頻，限頻後錯誤碼也為429000，但是請求頭中不會攜帶其他個人限頻信息。此類限頻不算限頻次數，建議稍後重試即可

另外，在1.0和2.0的過渡期間，可能還會遇到錯誤碼1015，建議稍後重試即可，如果頻繁出現，請聯繫官方社群處理 https://t.me/KuCoin_API