Skip to main content



The V5 API brings uniformity and efficiency to Bybit's product lines, unifying Spot, Derivatives, and Options in one set of specifications.

Current API Coverage


If your account is still a Unified Margin Account, you cannot trade spot through the V5 API. We strongly recommend upgrading to the Unified Trading Account.

OpenAPI VersionAccount TypeLinearInverseSpotOptions
USDT PerpetualUSDC PerpetualUSDC FuturesPerpetualFutures
V5Unified trading accountsee note
Classic account
V3Classic account

Note: the Unified account supports inverse trading. However, the margin used is from the inverse derivatives wallet instead of the unified wallet.

Key Upgrades

Product Lines Alignment

Previously, Spot V1/V3, Futures V2 and USDC Options V1 each had their own set of APIs which only covered a portion of Bybit's products. V5 unifies the APIs of various trading products into one, providing users the capability to trade Spot, Derivatives and Options contracts with a single API by distinguishing transactions through different order parameters. Consequently, there is no need to switch between multiple interfaces when building different products – regardless of tasks such as order management or querying wallet data – as the same API can be used to request and return results.

The global dictionary in V5 is uniquely defined to avoid scenarios where different terms are used for the same purposes, or where a single term has multiple references. This simplifies the troubleshooting process for users.

For example, when creating an order with POST V5/order/create, users can specify category=spot/linear/option to create multiple orders across different products.

Ease of Upgrade

API V5 is built upon V3, so minimal changes are required to upgrade. If you are already connected via Contract V3 or Unified V3, simply change the URL to the corresponding one of V5 and adjust some interface fields. Please refer to the interface mapping list below for more details about specific interfaces.

Enhance Capital Efficiency

V5 provides users the ability to upgrade accounts to a unified account, allowing for sharing and cross-utilization of funds across Spot, USDT Perpetual, USDC Perpetual and Options contracts. Users are also able to offset profit and losses across different positions, thus further enhancing capital efficiency.

Unified Account Borrowing

API V5 supports borrowing across a unified account mode. Users can pledge multiple assets as collateral to obtain margin for trading across different products.

For example: Trader Alice opens a USDT-settled BTCUSDT contract position while holding only BTC assets. If a floating loss is incurred, a debt will be recorded and interest will be charged hourly.

Paradigm Block Trading

Unified accounts now support block trading via Paradigm. Users can utilize funds across different products.

Portfolio Margin Mode

Unified Accounts now support combined margin between USDT Perpetual, USDC Perpetual, USDC Futures and Options contracts

API Interface Naming Standard

API V5 offers clearer path definitions for improved clarity and reduced ambiguity. The new version divides the API path into market data, order management, position management, account management, asset management, and more modules.


Address SegmentDescription
v5/market/Candlestick, orderbook, ticker, platform transaction data, underlying financial rules, risk control rules
v5/order/Order management
v5/position/Position management
v5/account/Single account operations only – unified funding account, rates, etc.
v5/asset/Operations across multiple accounts – asset management, fund management, etc.
v5/spot-lever-token/Obtain quotes from Leveraged Tokens on Spot, and to exercise purchase and redeem functions
v5/spot-margin-trade/Manage Margin Trading on Spot

API Rate Limit Adjustment

The rate limit has been adjusted in V5 to allocate a per-second rate limit quota for each User ID across products, to ensure smooth transactions and improve user experience.

  • V2 Rate Limit: “User ID + Symbol + API Endpoint” limits the frequency of API requests by a fixed number of counts per minute
  • V3 Rate Limit: “User ID + API Endpoint” limits the frequency of API requests by a fixed number of counts per second
  • V5 Rate Limit: “User ID + API Endpoint” limits the frequency of API requests by a fixed number of counts per second

For example:

  • In V2 Futures,
    • Trader Bob sets the order frequency of BTCUSDT at 400/m, ETHUSDT at 200/m, and other symbols at 100/m
    • If he places 200 order requests for BTCUSDT, his remaining limit in that one minute is 200 order requests for BTCUSDT, 200 for ETHUSDT and 100 for other symbols
    • If 100 ETHUSDT order requests are sent in at the same time, the remaining credit in that one minute is 200 order requests for BTCUSDT, 100 for ETHUSDT, and 100 for other symbols
  • In V3/V5,
    • The default limit is 10/s for all users
    • Trader Charlie increases his order frequency to 100/s (representing a maximum of 100 requests across all interfaces for a single UID)
    • He places 50 order requests for BTCUSDT in one second, which leaves a remaining limit of 50 order requests in that second
    • The frequency limit then resets to 100/s during the next second

Query-based APIs CANNOT increase in frequency and are limited to 10 requests per second (WebSocket is recommended for data reception).

No Change in Latency

Implemented since Jan 1, 2023, API V5 currently supports unified account trading with the same latencies as unified margin trading. The upcoming implementation for non-unified account trading will feature the same latency as API V3.

Single Placement Interface

With V2, submission of normal and conditional orders required two different APIs. API V3 and V5 merge orders via different submission parameters on one single placement interface. This eliminates the need for users to request multiple orders using different interfaces.

Addition of Real-Time Order Query

With V5, users can request the last 500 orders in real-time, as compared to API V3 which only supports real-time queries of unfilled orders.

The status of recently filled orders can also be queried in real-time, reducing the delay compared to querying through order or history interfaces.

Cancellation of Orders by Settlement Currency

Users can cancel all Derivatives orders settled by the same currency with settleCoin.

Addition of Historical Funding Rate Query

While API V2 only supports the query of funding rates from the previous cycle, API V3 and V5 support the query of funding rate changes, which allows users to conduct historical funding backtests.

Addition of Insurance Fund Interface

This interface addition allows for queries of the insurance pool, which users can use to check for any insurance fund updates on the Bybit platform.

Additional WebSocket Data

More WebSocket data has been added to provide a range of orderbook data at different frequencies and depths. Push frequency has no change, but depth has been increased from 25 to 50. Please refer to the WebSocket interface description for more details.

The updated orderbook now checks for data continuity to ensure that local orderbook data is correct. A Seq (sequence) field has also been added to help determine the sequence of pulled data, so users can respond efficiently to market changes.

ProductDepth 1Depth 25Depth 50Depth 100Depth 200Depth 500

Increase in Post Only Orders

Under Derivatives, the submission of Post Only orders allows users to place more orderQty for each symbol – typically up to five times the usual orderQty. Users can use the instrument-info endpoint to obtain the maximum number of orders that can be traded for each symbol.

Uniform and Precise Data

Previous APIs returned data as E2 and E8. API V3 and V5 return data as actual values, eliminating the need for users to implement conversion logic.

Readability Improvements to API Documentation

The API documentation has been revised and proofread to improve clarity and reduce confusion. Any parts of the previous documentation that were not clear have been revised to provide better explanations.

V5 and V3 Interface Mapping List

ModuleV5 EndpointV3 Endpoint
Spot Leverage Token/v5/spot-lever-token/info/spot/v3/public/infos
Spot Margin Trade/v5/spot-margin-trade/switch-mode/spot/v3/private/cross-margin-switch
WebSocket Publicwss://
WebSocket Privatewss://