跳至主要内容

頻率限制

IP限頻​

HTTP IP限頻​

默認情況下, 每個IP允許在每5秒的時間窗口內發送最多600次請求。這個速率限制將統計所有打到api.zoomex.com域名的請求數量。 如果您遇到了“403, access too frequent”這樣的報錯, 它表示您的IP已經超過了限定的頻率, 這種情況下, 您應當斷開所有來自這個IP的活著的HTTP會話, 然後休息至少10分鐘。IP將會自動解除限制。

我們不建議您在這些限制的邊緣運行您的應用程序，以防異常的網絡活動導致意外違規。

Websocket IP 限頻​

不要在5分鐘內構建超過500個連接, 這個限頻適用於所有發往stream.zoomex.com 以及本地站域名, 比如 stream.zoomex.kz的連接請求; 不要嘗試頻繁地構建連接與斷開連接; 訂閱行情數據時, 每個IP不要構建超過1,000個連接, 現貨、U本位期貨、幣本位期貨分開計算。

賬戶頻率限製​

警告

如果您收到這樣的響應"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/create10 req/s10 req/sY
/cloud/trade/v3/order/amend10 req/s10 req/sY
/cloud/trade/v3/order/cancel10 req/s10 req/sY
/cloud/trade/v3/order/cancel-all10 req/s10 req/sN
GET/cloud/trade/v3/order/realtime10 req/s10 req/sN
/cloud/trade/v3/order/history10 req/s10 req/sN

持倉​

請求方式路徑正向/反向合約是否可提頻
GET/cloud/trade/v3/position/list10 req/sN
/cloud/trade/v3/execution/list10 req/sN
/cloud/trade/v3/position/closed-pnl10 req/sN
POST/cloud/trade/v3/position/set-leverage10 req/sN
/cloud/trade/v3/position/set-tpsl-mode10 req/sN
/cloud/trade/v3/position/set-risk-limit10 req/sN
/cloud/trade/v3/position/trading-stop10 req/sN

帳戶​

請求方式路徑頻率是否可提頻
GET/cloud/trade/v3/account/wallet-balance10 req/sN
/cloud/trade/v3/account/fee-rate10 req/sN

不同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，會報錯超過上限，下單失敗。

普通帳戶
等級\產品期貨
默認10/s
VIP 120/s
VIP 240/s
VIP 3 - 至尊VIP60/s
PRO1100/s
PRO2150/s
PRO3200/s

UID 層級​

Level\ProductFuturesSpot
PRO1200/s200/s
PRO2400/s400/s
PRO3600/s600/s
PRO4800/s800/s
PRO51000/s1000/s
PRO61200/s1200/s

主帳戶和子帳戶層級​

Level\ProductFuturesSpot
PRO110000/s10000/s
PRO220000/s20000/s
PRO330000/s30000/s
PRO440000/s40000/s
PRO550000/s50000/s
PRO660000/s60000/s

設定 API 速率限制​

信息
  • 如果請求者是母帳戶，需要提頻的 UID 必須屬於該母帳戶。
  • 如果請求者非母帳戶，則提頻的 UID 必須是自己。
  • UID 必須屬於機構用户。

HTTP 請求​

POST /cloud/trade/v3/apilimit/set

請求參數​

參數是否必需類型說明
listtruearrayObject
> uidstruestringuid 列表，多個以逗號隔開
> bizTypetruestring業務類型
> ratetrueintegerapi rate limit 每秒頻率

響應參數​

參數類型說明
listarrayObject
> uidsstringuid 列表，多個以逗號隔開
> bizTypestring業務類型
> rateintegerapi rate limit 每秒頻率
> successboolean是否成功
> msgstring結果訊息

請求實例​

POST /cloud/trade/v3/apilimit/set HTTP/1.1
Host: openapi-testnet.zoomex.com
X-BAPI-SIGN: XXXXXXX
X-BAPI-API-KEY: xxxxxxxxxxxxxxxxxx
X-BAPI-TIMESTAMP: 1711420489915
X-BAPI-RECV-WINDOW: 5000
Content-Type: application/json

{
    "list": [
        {
            "uids": "106293838",
            "bizType": "DERIVATIVES",
            "rate": 50
        }
    ]
}

響應示例​

{
  "retCode": 0,
  "retMsg": "success",
  "result": {
    "result": [
      {
        "uids": "290118",
        "bizType": "SPOT",
        "rate": 600,
        "success": true,
        "msg": "API limit updated successfully"
      }
    ]
  },
  "retExtInfo": {},
  "time": 1754894296913
}

查詢 API 速率限制​

信息
  • 母帳戶能查詢自己和子帳戶的頻率；子帳戶只能查詢自己的頻率。

HTTP 請求​

GET /cloud/trade/v3/apilimit/query

請求參數​

參數是否必需類型說明
uidstruestringuid 列表，多個以逗號隔開

響應參數​

參數類型說明
listarrayObject
> uidsstringuid 列表，多個以逗號隔開
> bizTypestring業務類型
> rateintegerapi rate limit 每秒頻率

請求示例​

GET /cloud/trade/v3/apilimit/query?uids=290118 HTTP/1.1
Host: openapi-testnet.zoomex.com
X-BAPI-SIGN: XXXXXXX
X-BAPI-API-KEY: xxxxxxxxxxxxxxxxxx
X-BAPI-TIMESTAMP: 1728460942776
X-BAPI-RECV-WINDOW: 5000
Content-Type: application/json
Content-Length: 2

響應示例​

{
  "retCode": 0,
  "retMsg": "success",
  "result": {
    "list": [
      {
        "uids": "290118",
        "bizType": "SPOT",
        "rate": 600
      },
      {
        "uids": "290118",
        "bizType": "DERIVATIVES",
        "rate": 400
      }
    ]
  },
  "retExtInfo": {},
  "time": 1754894341984
}

如何提高頻率限製​

請聯繫您的客戶經理或者發送郵件到 support@zoomex.com，我們會在 1-4 個工作日內答復。郵件內容必須包含以下內容：

  1. 您的姓名和公司名稱和簡介
  2. 您的zoomex 賬號uid或註冊郵箱手機號,以及您要申請提頻的交易對
  3. 您上個月的交易量（吃單/掛單）並提供截圖
  4. 簡單介紹您的交易策略和為什麽需要更高限頻
  5. 如果可以，請提供您的成交記錄csv文檔