頻率限制
IP限頻
如果您收到HTTP 403（拒絕訪問）響應, 您的 IP 已被暫時或永久禁止。 您應立即查看以下指南，以確保您的應用程序不會繼續違反限制。如果您在 30 分鐘後 仍被禁止，則您可能會被永久禁止。
我們不建議您在這些限制的邊緣運行您的應用程序，以防異常的網絡活動導致意外違規。
GET/POST請求 (共享):- 連續 5 秒內每秒不超過 120 個請求
所有到openapi.zoomex.com的流量共享此限制。
違反限制後，您的 IP 將被禁止一段時間（通常為 30 分鐘）。 持續違反限制將導致永久禁止。 我們不能撤銷永久禁令或縮短臨時禁令。
賬戶頻率限製
如果您收到這樣的響應"ret_msg": "Too many visits!", 則表示您觸發了帳戶頻率限制, 請等到頻率限制重置以後, 再繼續發送請求。
Zoomex基於每秒鍾的滾動時間窗口來做頻率限製，並且是按賬戶（uid）來做劃分限製，每次請求API響應頭(response header)中都會包含如下字段：
X-Bapi-Limit-Status- 該接口當前時間窗口剩余可用請求數X-Bapi-Limit- 該接口當前頻率限製上限X-Bapi-Limit-Reset-Timestamp- 如果您已超過該接口當前窗口頻率限製，該字段表示下個可用時間窗口的時間戳（毫秒），即什麽時候可以恢復訪問；如果您未超過該接口當前窗口頻率限製，該字段表示返回的是當前服務器時間（毫秒).
Http 響應頭示例
▶Response Headers
Content-Type: application/json; charset=utf-8
Content-Length: 141
X-Bapi-Limit: 100
X-Bapi-Limit-Status: 99
X-Bapi-Limit-Reset-Timestamp: 1672738134824
接口頻率限制表
交易
| 請求方式 | 路徑 | 正向合約 | 反向合約 | 是否可提頻 |
|---|---|---|---|---|
| POST | /cloud/trade/v3/order/create | 10 req/s | 10 req/s | Y |
| /cloud/trade/v3/order/amend | 10 req/s | 10 req/s | Y | |
| /cloud/trade/v3/order/cancel | 10 req/s | 10 req/s | Y | |
| /cloud/trade/v3/order/cancel-all | 10 req/s | 10 req/s | N | |
| /cloud/trade/v3/order/create-batch | - | - | Y | |
| /cloud/trade/v3/order/amend-batch | - | - | Y | |
| /cloud/trade/v3/order/cancel-batch | - | - | Y | |
| GET | /cloud/trade/v3/order/realtime | 10 req/s | 10 req/s | N |
| /cloud/trade/v3/order/history | 10 req/s | 10 req/s | N |
持倉
| 請求方式 | 路徑 | 正向/反向合約 | 是否可提頻 |
|---|---|---|---|
| GET | /cloud/trade/v3/position/list | 10 req/s | N |
| /cloud/trade/v3/execution/list | 10 req/s | N | |
| /cloud/trade/v3/position/closed-pnl | 10 req/s | N | |
| POST | /cloud/trade/v3/position/set-leverage | 10 req/s | N |
| /cloud/trade/v3/position/set-tpsl-mode | 10 req/s | N | |
| /cloud/trade/v3/position/set-risk-limit | 10 req/s | N | |
| /cloud/trade/v3/position/trading-stop | 10 req/s | N |
帳戶
| 請求方式 | 路徑 | 頻率 | 是否可提頻 |
|---|---|---|---|
| GET | /cloud/trade/v3/account/wallet-balance | 10 req/s | N |
| /cloud/trade/v3/account/fee-rate | 10 req/s | N |
不同VIP/PRO等級的接口限頻規則
- 表格中的數值，代表對應等級的可申請上限，並不代表處於該等級的用戶實際默認自動享有對應的API Rate Limit
批量下單的接口，api rate limit：接口的頻次，還是統一沿用當前配置，但是計數消耗會根據實際的訂單數來消耗。（消耗數=請求數*請求中包含的訂單數），業務線配置相互獨立。
批量接口允許1-20orders/request，例如，批量下單請求一次，包含10個orders，則本次請求limit數量消耗10。
若1s內的最後一次請求的批量訂單，部分超限，則超過的部分會失敗（報錯超過上限），未超過的部分會成功。例如，這1s中，limit還剩10，但是此時下了一個包含15個orders的批量請求， 那麼前10個orders會下單成功，11-15的orders，會報錯超過上限，下單失敗。
| 普通帳戶 & UTA | UTA Pro | |
|---|---|---|
| 等級\產品 | 期貨 | 期貨 |
| 默認 | 10/s | 10/s |
| VIP 1 | 20/s | 20/s |
| VIP 2 | 40/s | 40/s |
| VIP 3 - 至尊VIP | 60/s | 60/s |
| PRO1 | 100/s | 150/s |
| PRO2 | 150/s | 200/s |
| PRO3 | 200/s | 250/s |
如何提高頻率限製
請聯繫您的客戶經理或者發送郵件到 support@zoomex.com，我們會在 1-4 個工作日內答復。郵件內容必須包含以下內容：
- 您的姓名和公司名稱和簡介
- 您的zoomex 賬號uid或註冊郵箱手機號,以及您要申請提頻的交易對
- 您上個月的交易量（吃單/掛單）並提供截圖
- 簡單介紹您的交易策略和為什麽需要更高限頻
- 如果可以，請提供您的成交記錄csv文檔