基礎頻率限制
IP限頻
HTTP IP限頻
默認情況下, 每個IP允許在每5秒的時間窗口內發送最多600次請求。這個速率限制將統計所有打到api.bybit.com, api.bybick.com, 以及本地站api.bybit.kz等域名的請求數量。
如果您遇到了“403, access too frequent”這樣的報錯, 它表示您的IP已經超過了限定的頻率, 這種情況下, 您應當斷開所有來自這個IP的活著的HTTP會話, 然後休息至少10分鐘。IP將會自動解除限制。
我們不建議您在這些限制的邊緣運行您的應用程序，以防異常的網絡活動導致意外違規。
Websocket IP 限頻
- 不要在5分鐘內構建超過500個連接, 這個限頻適用於所有發往
stream.bybit.com以及本地站域名, 比如stream.bybit.kz的連接請求; - 不要嘗試頻繁地構建連接與斷開連接;
- 訂閱行情數據時, 每個IP不要構建超過1,000個連接, 現貨、U本位期貨、幣本位期貨以及期權分開計算。
賬戶頻率限製
警告
如果您收到這樣的響應"retCode": 10006, "retMsg": "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: 10
X-Bapi-Limit-Status: 9
X-Bapi-Limit-Reset-Timestamp: 1672738134824
接口頻率限制表
交易
| 請求方式 | 路徑 | 統一帳戶 | 是否可提頻 | |||
|---|---|---|---|---|---|---|
| inverse | linear | option | spot | |||
| POST | /v5/order/create | 10/s | 10/s | 20/s | Y | |
| /v5/order/amend | 10/s | 10/s | 10/s | Y | ||
| /v5/order/cancel | 10/s | 10/s | 20/s | Y | ||
| /v5/order/cancel-all | 10/s | 1/s | 20/s | Y | ||
| /v5/order/create-batch | 10/s | 10/s | 20/s | Y | ||
| /v5/order/amend-batch | 10/s | 10/s | 20/s | Y | ||
| /v5/order/cancel-batch | 10/s | 10/s | 20/s | Y | ||
| /v5/order/disconnected-cancel-all | 5/s | N | ||||
| /v5/order/pre-check | 10/s | 10/s | 20/s | Y | ||
| GET | /v5/order/realtime | 50/s | N | |||
| /v5/order/history | 50/s | N | ||||
| /v5/execution/list | 50/s | N | ||||
| /v5/order/spot-borrow-check | - | 50/s | N | |||
| POST | /v5/fcombobot/getlimit | 10/s | - | - | N | |
| /v5/fcombobot/create | 10/s | - | - | N | ||
| /v5/fcombobot/close | 10/s | - | - | N | ||
| /v5/fcombobot/detail | 10/s | - | - | N | ||
| /v5/fgridbot/validate | 10/s | - | - | N | ||
| /v5/fgridbot/create | 10/s | - | - | N | ||
| /v5/fgridbot/close | 10/s | - | - | N | ||
| /v5/fgridbot/detail | 10/s | - | - | N | ||
| /v5/fmartingalebot/getlimit | 10/s | - | - | N | ||
| /v5/fmartingalebot/create | 100/s | - | - | N | ||
| /v5/fmartingalebot/close | 10/s | - | - | N | ||
| /v5/fmartingalebot/detail | 10/s | - | - | N | ||
| /v5/grid/validate-input | - | 100/s | N | |||
| /v5/grid/create-grid | - | 3/s | N | |||
| /v5/grid/close-grid | - | 3/s | N | |||
| /v5/grid/query-grid-detail | - | 10/s | N | |||
| /v5/dca/create-bot | - | 3/s | N | |||
| /v5/dca/close-bot | - | 3/s | N | |||
| /v5/strategy/create | 100/s | - | 100/s | N | ||
| GET | /v5/strategy/list | 200/s | - | 200/s | N | |
| /v5/strategy/order-list | 200/s | - | 200/s | N | ||
| POST | /v5/strategy/stop | 100/s | - | 100/s | N | |
持倉
| 請求方式 | 路徑 | 統一帳戶 | 是否可提頻 | |||
|---|---|---|---|---|---|---|
| inverse | linear | option | spot | |||
| GET | /v5/position/list | 50/s | - | N | ||
| /v5/position/closed-pnl | 50/s | - | - | N | ||
| /v5/position/get-closed-positions | - | - | 50/s | - | N | |
| /v5/position/move-history | 10/s | N | ||||
| POST | /v5/position/set-leverage | 10/s | - | - | N | |
| /v5/position/switch-mode | - | 10/s | - | - | N | |
| /v5/position/trading-stop | 10/s | - | N | |||
| /v5/position/set-auto-add-margin | - | 10/s | - | - | N | |
| /v5/position/add-margin | 10/s | - | - | N | ||
| /v5/position/confirm-pending-mmr | 10/s | - | - | N | ||
| /v5/position/move-positions | 10/s | N | ||||
帳戶
| 請求方式 | 路徑 | 頻率 | 是否可提頻 | |
|---|---|---|---|---|
| GET | /v5/account/wallet-balance | accountType=UNIFIED | 50/s | N |
| /v5/account/withdrawal | 50/s | N | ||
| /v5/account/borrow-history | 50/s | N | ||
| /v5/account/borrow | 1/s | N | ||
| /v5/account/repay | 1/s | N | ||
| /v5/account/no-convert-repay | 1/s | N | ||
| /v5/account/collateral-info | 50/s | N | ||
| /v5/asset/coin-greeks | 50/s | N | ||
| /v5/account/transaction-log | accountType=UNIFIED | 50/s | N | |
| /v5/account/fee-rate | 5/s | N | ||
| /v5/account/info | 50/s | N | ||
| /v5/account/instruments-info | 10/s | N | ||
| /v5/account/mmp-state | - | N | ||
| /v5/account/option-asset-info | - | N | ||
| /v5/account/pay-info | 50/s | N | ||
| /v5/account/query-dcp-info | 5/s | N | ||
| /v5/account/smp-group | 5/s | N | ||
| /v5/account/trade-info-for-analysis | 50/s | N | ||
| /v5/account/user-setting-config | 50/s | N | ||
| POST | /v5/account/mmp-modify | 5/s | N | |
| /v5/account/mmp-reset | 5/s | N | ||
| /v5/account/quick-repayment | 1/s | N | ||
| /v5/account/set-collateral-switch | - | N | ||
| /v5/account/set-collateral-switch-batch | 5/s | N | ||
| /v5/account/set-delta-mode | - | N | ||
| /v5/account/set-hedging-mode | - | N | ||
| /v5/account/set-limit-px-action | 10/s | N | ||
| /v5/account/set-margin-mode | 5/s | N | ||
| /v5/account/upgrade-to-uta | 1/s | N |
資產
| 請求方式 | 路徑 | 頻率 | 是否可提頻 |
|---|---|---|---|
| GET | /v5/asset/transfer/query-asset-info | 60 req/min | N |
| /v5/asset/transfer/query-transfer-coin-list | 60 req/min | N | |
| /v5/asset/transfer/query-inter-transfer-list | 60 req/min | N | |
| /v5/asset/transfer/query-sub-member-list | 60 req/min | N | |
| /v5/asset/transfer/query-universal-transfer-list | 5 req/s | N | |
| /v5/asset/transfer/query-account-coins-balance | 5 req/s | N | |
| /v5/asset/transfer/query-account-coin-balance | 450 req/s | N | |
| /v5/asset/asset-overview | 50 req/s | N | |
| /v5/asset/withdraw/withdrawable-amount | 300 req/s | N | |
| /v5/asset/deposit/query-record | 100 req/min | N | |
| /v5/asset/deposit/query-sub-member-record | 300 req/min | N | |
| /v5/asset/deposit/query-address | 300 req/min | N | |
| /v5/asset/deposit/query-sub-member-address | 300 req/min | N | |
| /v5/asset/withdraw/query-record | 300 req/min | N | |
| /v5/asset/coin/query-info | 5 req/s | N | |
| /v5/asset/exchange/order-record | 600 req/min | N | |
| /v5/asset/exchange/query-coin-list | 30 req/s | N | |
| /v5/asset/covert/small-balance-history | 5 req/s | N | |
| /v5/asset/covert/small-balance-list | 10 req/s | N | |
| /v5/asset/delivery-record | 50 req/s | N | |
| /v5/asset/deposit/query-internal-record | 300 req/s | N | |
| /v5/fiat/balance-query | 1000 req/s | N | |
| /v5/fiat/query-coin-list | 1000 req/s | N | |
| /v5/fiat/trade-query | 1000 req/s | N | |
| /v5/fiat/query-trade-history | 1000 req/s | N | |
| /v5/asset/fundinghistory | 30 req/s | N | |
| /v5/asset/portfolio-margin | 50 req/s | N | |
| /v5/asset/settlement-record | 50 req/s | N | |
| /v5/asset/total-members-assets | 50 req/s | N | |
| /v5/asset/withdraw/vasp/list | 1 req/s | N | |
| /v5/asset/withdraw/query-address | 300 req/s | N | |
| POST | /v5/asset/transfer/inter-transfer | 60 req/min | N |
| /v5/asset/transfer/save-transfer-sub-member | 20 req/s | N | |
| /v5/asset/transfer/universal-transfer | 5 req/s | N | |
| /v5/asset/withdraw/create | 5 req/s | N | |
| /v5/asset/withdraw/cancel | 60 req/min | N | |
| /v5/asset/exchange/quote-apply | 20 req/s | N | |
| /v5/asset/exchange/convert-execute | 20 req/s | N | |
| /v5/asset/covert/small-balance-execute | 5 req/s | N | |
| /v5/asset/covert/get-quote | 5 req/s | N | |
| /v5/asset/deposit/deposit-to-account | 300 req/s | N | |
| /v5/fiat/trade-execute | 100 req/s | N | |
| /v5/fiat/quote-apply | 1000 req/s | N | |
| GET | /v5/asset/exchange/convert-result-query | 50 req/s | N |
| /v5/asset/exchange/query-convert-history | 50 req/s | N | |
| /v5/fiat/reference-price | 1000 req/s | N |
用戶
| 請求方式 | 路徑 | 頻率 | 是否可提頻 |
|---|---|---|---|
| POST | /v5/user/create-sub-member | 1 req/s | N |
| /v5/user/create-sub-api | 1 req/s | N | |
| /v5/user/frozen-sub-member | 5 req/s | N | |
| /v5/user/update-api | 5 req/s | N | |
| /v5/user/update-sub-api | 5 req/s | N | |
| /v5/user/delete-api | 5 req/s | N | |
| /v5/user/delete-sub-api | 5 req/s | N | |
| GET | /v5/user/query-sub-members | 10 req/s | N |
| /v5/user/query-api | 10 req/s | N | |
| /v5/user/aff-customer-info | 10 req/s | N | |
| POST | /v5/user/agreement | 20 req/s | N |
| GET | /v5/user/submembers | 5 req/s | N |
| /v5/user/escrow_sub_members | 5 req/s | N | |
| /v5/user/sub-apikeys | 10 req/s | N | |
| /v5/user/get-member-type | 10 req/s | N | |
| POST | /v5/user/del-submember | 5 req/s | N |
| GET | /v5/user/invitation/referrals | 10 req/s | N |
全倉槓桿
| 請求方式 | 路徑 | 頻率 | 是否可提頻 |
|---|---|---|---|
| POST | 全倉槓桿開關 | 5 req/s | N |
| POST | 全倉槓桿設置 | 5 req/s | N |
| GET | 查詢開關狀態和倍數 | 50 req/s | N |
| GET | 查詢最大可借數 | 50 req/s | N |
| GET | 查詢幣種槓桿 | 50 req/s | N |
| GET | 查詢負債幣種可還款金額 | 50 req/s | N |
| POST | 設定現貨自動還款模式 | 5 req/s | N |
| GET | 獲取現貨自動還款模式 | 50 req/s | N |
| GET | 查詢固定利率借款掛單報價 | 5 req/s | N |
| POST | 固定利率借款 | 1 req/s | N |
| POST | 固定利率借款續借 | 1 req/s | N |
| GET | 查詢固定利率借款訂單信息 | 5 req/s | N |
| GET | 查詢固定利率借款合約信息 | 5 req/s | N |
| GET | 查詢負債信息 | 5 req/s | N |
價差交易
| 請求方式 | 路徑 | 頻率 | 是否可提頻 |
|---|---|---|---|
| POST | 創建價差委托單 | 20 req/s | N |
| POST | 修改價差委託單 | 20 req/s | N |
| POST | 撤銷價差委託單 | 20 req/s | N |
| POST | 價差-全部撤單 | 5 req/s | N |
| GET | 查詢價差活動單 | 50 req/s | N |
| GET | 查詢價差訂單歷史 | 50 req/s | N |
| GET | 查詢價差成交歷史 | 50 req/s | N |
| GET | 查詢最大下單數量 | 50 req/s | N |
RFQ
| 請求方式 | 路徑 | 頻率 | 是否可提頻 |
|---|---|---|---|
| POST | 取消所有報價單 | 50 req/s | N |
| POST | 取消報價單 | 50 req/s | N |
| POST | 接受非 LP 報價 | 50 req/s | N |
| POST | 取消所有詢價單 | 50 req/s | N |
| POST | 報價 | 50 req/s | N |
| POST | 詢價 | 50 req/s | N |
| POST | 執行報價 | 50 req/s | N |
| POST | 取消詢價單 | 50 req/s | N |
| GET | 獲取rfq公共成交數據 | 50 req/s | N |
| GET | 獲取歷史報價 | 50 req/s | N |
| GET | 獲取即時報價 | 50 req/s | N |
| GET | rfq配寘資訊 | 50 req/s | N |
| GET | 獲取歷史詢價資訊 | 50 req/s | N |
| GET | 獲取實时的詢價單資訊 | 50 req/s | N |
| GET | 獲取交易資訊 | 50 req/s | N |
機構借貸
| 請求方式 | 路徑 | 頻率 | 是否可提頻 |
|---|---|---|---|
| GET | 查詢產品信息 | 100 req/s | N |
| GET | 查詢保證金幣種信息 | 100 req/s | N |
| GET | 查詢借貸訂單信息 | 20 req/s | N |
| GET | 查詢還款信息 | 20 req/s | N |
| GET | 查詢風險率 | 20 req/s | N |
| POST | 綁定/解綁UID | 1 req/s | N |
| POST | 還款 | 1 req/s | N |
批量接口限頻說明
提示
批次訂單接口（包括創建、修改和取消）的速率限制不會與單一的下改撤請求共享。例如，單一下單接口頻率是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，會報錯超過上限，下單失敗。