REST API

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

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

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

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

Level Spot Futures ManageMent Public
VIP0 3000/30s 2000/30s 2000/30s 2000/30s
VIP1 3000/30s 2000/30s 2000/30s 2000/30s
VIP2 6000/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