跳至主要内容

頻率限制

IP限頻

警告

如果您收到HTTP 403(拒絕訪問)響應, 您的 IP 已被暫時或永久禁止。 您應立即查看以下指南,以確保您的應用程序不會繼續違反限制。如果您在 30 分鐘後 仍被禁止,則您可能會被永久禁止。

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

  • GET/POST 請求 (共享):
    • 任意連續 5 秒的滾動窗口內不超過 600 個請求
備註

所有到api.bybit.comapi.bytick.com的流量共享此限制,無論是訪問現貨、期貨還是期權。

違反限制後,您的 IP 將被禁止一段時間(通常為 30 分鐘)。 持續違反限制將導致永久禁止。 我們不能撤銷永久禁令或縮短臨時禁令。

賬戶頻率限製

警告

如果您收到這樣的響應"ret_msg": "Too many visits!", 則表示您觸發了帳戶頻率限制, 請等到頻率限制重置以後, 再繼續發送請求。

Bybit基於每秒鍾的滾動時間窗口來做頻率限製,並且是按賬戶(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

接口頻率限制表

交易

請求方式路徑經典帳戶是否可提頻
inverselinearspot
POST/v5/order/create10/s20/sY
/v5/order/amend10/s10/sY
/v5/order/cancel10/s20/sY
/v5/order/cancel-all10/s20/sN
GET/v5/order/realtime10/s20/sN
/v5/order/history10/s20/sN
/v5/execution/list10/s20/sN

持倉

請求方式路徑經典帳戶是否可提頻
inverselinearspot
GET/v5/position/list10/s-N
/v5/position/closed-pnl10/s-N
POST/v5/position/set-leverage10/s-N

账户

請求方式路徑頻率是否可提頻
GET/v5/account/contract-transaction-log10/sN
/v5/account/wallet-balanceaccountType=SPOT20/sN
accountType=CONTRACT10/sN
/v5/account/fee-ratecategory=linear10/sN
category=spot5/sN
category=option5/sN

資產

請求方式路徑頻率是否可提頻
GET/v5/asset/transfer/query-asset-info60 req/minN
/v5/asset/transfer/query-transfer-coin-list60 req/minN
/v5/asset/transfer/query-inter-transfer-list60 req/minN
/v5/asset/transfer/query-sub-member-list60 req/minN
/v5/asset/transfer/query-universal-transfer-list5 req/sN
/v5/asset/transfer/query-account-coins-balance5 req/sN
/v5/asset/deposit/query-record100 req/minN
/v5/asset/deposit/query-sub-member-record300 req/minN
/v5/asset/deposit/query-address300 req/minN
/v5/asset/deposit/query-sub-member-address300 req/minN
/v5/asset/withdraw/query-record300 req/minN
/v5/asset/coin/query-info5 req/sN
/v5/asset/exchange/order-record600 req/minN
POST/v5/asset/transfer/inter-transfer60 req/minN
/v5/asset/transfer/save-transfer-sub-member20 req/sN
/v5/asset/transfer/universal-transfer5 req/sN
/v5/asset/withdraw/create1 req/sN
/v5/asset/withdraw/cancel60 req/minN

用戶

請求方式路徑頻率是否可提頻
POSTv5/user/create-sub-member5 req/sN
/v5/user/create-sub-api5 req/sN
/v5/user/frozen-sub-member5 req/sN
/v5/user/update-api5 req/sN
/v5/user/update-sub-api5 req/sN
/v5/user/delete-api5 req/sN
/v5/user/delete-sub-api5 req/sN
GET/v5/user/query-sub-members10 req/sN
/v5/user/query-api10 req/sN
/v5/user/aff-customer-info10 req/sN

槓桿代幣

請求方式路徑頻率是否可提頻
GET/v5/spot-lever-token/order-record50 req/sN
POST/v5/spot-lever-token/purchase20 req/sN
POST/v5/spot-lever-token/redeem20 req/sN

全倉槓桿 (統一帳戶)

目前,該目錄下的接口沒有頻率限制

全倉槓桿 (經典帳戶)

請求方式路徑頻率是否可提頻
GET/v5/spot-cross-margin-trade/loan-info50 req/sN
GET/v5/spot-cross-margin-trade/account50 req/sN
GET/v5/spot-cross-margin-trade/orders50 req/sN
GET/v5/spot-cross-margin-trade/repay-history50 req/sN
POST/v5/spot-cross-margin-trade/loan20 req/sN
POST/v5/spot-cross-margin-trade/repay20 req/sN
POST/v5/spot-cross-margin-trade/switch20 req/sN

不同VIP/PRO等級的接口限頻規則

信息

表格中的數值, 代表對應等級的可申請上限, 並不代表處於該等級的用戶實際默認自動享有對應的API Rate Limit

批量接口特別說明

批次訂單接口(包括創建、修改和取消)的速率限制不會與單一的下改撤請求共享。例如,單一下單接口頻率是100/秒, 批量下單接口是100/秒,,那麼當結合兩個接口一起下單時, 就擁有200單每秒的能力

僅category=linear, inverse或spot時

  • 批量下單的接口,api rate limit:接口的頻次,還是統一沿用當前配置,但是計數消耗會根據實際的訂單數來消耗。(消耗數 = 請求數 * 請求中包含的訂單數),業務線配置相互獨立。

  • 批量接口允許1-10orders/request,例如,批量下單請求一次,包含5個orders,則本次請求limit數量消耗5。

  • 若1s內的最後一次請求的批量訂單,部分超限,則超過的部分會失敗(報錯超過上限),未超過的部分會成功。例如,這1s中,limit還剩5,但是此時下了一個包含8個orders的批量請求, 那麼前5個orders會下單成功,第6-8的orders,會報錯超過上限,下單失敗。

經典帳戶UTA Pro
等級\產品期貨期權現貨期貨期權現貨
默認10/s10/s20/s10/s10/s20/s
VIP 120/s20/s25/s20/s20/s25/s
VIP 240/s40/s30/s40/s40/s30/s
VIP 360/s60/s40/s60/s60/s40/s
VIP 460/s60/s40/s60/s60/s40/s
VIP 560/s60/s40/s60/s60/s40/s
至尊VIP60/s60/s40/s60/s60/s40/s
PRO1100/s100/s50/s150/s150/s150/s
PRO2150/s150/s75/s200/s200/s200/s
PRO3200/s200/s100/s250/s250/s250/s
PRO4200/s200/s100/s300/s300/s300/s
PRO5200/s200/s100/s300/s300/s300/s
PRO6200/s200/s100/s300/s300/s300/s

如何提高頻率限製

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

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