--- title: "Bybit" description: "Our Bybit integration lets you deploy live trading algorithms on our co-located servers that trade the capital you have in your Bybit account." canonical: https://www.quantconnect.com/docs/v2/cloud-platform/live-trading/brokerages/bybit markdown: https://www.quantconnect.com/docs/v2/cloud-platform/live-trading/brokerages/bybit.md language: python source: https://github.com/QuantConnect/Documentation/tree/master/01%20Cloud%20Platform/10%20Live%20Trading/02%20Brokerages/11%20Bybit modified: 2026-11-02 index: https://www.quantconnect.com/llms.txt --- # Bybit [Documentation](https://www.quantconnect.com/docs/v2.md) > [Cloud Platform](https://www.quantconnect.com/docs/v2/cloud-platform.md) > [Live Trading](https://www.quantconnect.com/docs/v2/cloud-platform/live-trading.md) > [Brokerages](https://www.quantconnect.com/docs/v2/cloud-platform/live-trading/brokerages.md) > Bybit > Code examples are shown in Python. Append `?lang=csharp` to this URL for the C# version of this page. ## Introduction QuantConnect enables you to run your algorithms in live mode with real-time market data. Bybit was co-founded by Ben Zhou in March 2018 with the goal to offer a professional platform where Crypto traders can find an ultra-fast matching engine, excellent customer service, and multilingual community support. Bybit provides access to trading Crypto and Crypto Futures for clients outside of [excluded jurisdictions](https://www.bybit.com/en/help-center/article/Service-Restricted-Countries) with low minimum deposits to set up an account. For more information about [Crypto](https://www.bybit.com/en/help-center/article/Bybit-Deposit-FAQ#b) and [fiat deposits](https://www.bybit.com/en/help-center/article/FAQ-Fiat-Deposit), see the Bybit documentation. Bybit also provides Crypto staking, initial DEX offerings, and community airdrops. To view the implementation of the Bybit brokerage integration, see the [Lean.Brokerages.Bybit repository](https://github.com/QuantConnect/Lean.Brokerages.Bybit). ## Account Types Bybit supports cash and margin accounts. To set the account type in an algorithm, see the [Bybit brokerage model documentation](https://www.quantconnect.com/docs/v2/writing-algorithms/reality-modeling/brokerages/supported-models/bybit.md). ### Create an Account Follow the [How to Register an Account](https://www.bybit.com/en/help-center/article/How-to-register-an-account) tutorial on the Bybit website to create a Bybit account. You will need API credentials to deploy live algorithms. After you have an account, [create API credentials](https://www.bybit.com/en/help-center/article/How-to-create-your-API-key) and store them somewhere safe. As you create credentials, make the following configurations: - Under API Key Usage, select **API Transaction**. - Choose a name for the API key. - Under API Key Permissions, select **Read-Write**. - Select the **Only IPs with permissions granted are allowed to access the OpenAPI** check box and then enter our IP addresses, 146.59.85.21, 57.128.231.46 and 57.128.233.143. - Select the **Unified Trading** check box. Unified trading enables read-write permissions for the following queries: - Order - Positions - Trade ### Paper Trading Bybit supports paper trading through two environments: [Bybit Demo Trading](https://www.bybit.com/en/help-center/article/FAQ-Demo-Trading) and the [Bybit Testnet](https://testnet.bybit.com/). Each environment uses a separate set of API credentials, so you can't reuse your live account keys. Follow these steps to set up paper trading with Bybit Demo Trading: 1. Log in to your [Bybit account](https://www.bybit.com/). 2. From your account menu, switch to **Demo Trading**. 3. [Create API credentials](https://www.bybit.com/en/help-center/article/How-to-create-your-API-key) in the Demo Trading environment and store them somewhere safe. Follow these steps to set up paper trading with the Bybit Testnet: 1. Log in to the [Bybit Testnet](https://testnet.bybit.com/). 2. [Create API credentials](https://www.bybit.com/en/help-center/article/How-to-create-your-API-key) on the Testnet and store them somewhere safe. ## Asset Classes Our Bybit integration supports trading [Crypto](https://www.quantconnect.com/docs/v2/writing-algorithms/securities/asset-classes/crypto.md) and [Crypto Futures](https://www.quantconnect.com/docs/v2/writing-algorithms/securities/asset-classes/crypto-futures.md). ## Data Providers The [QuantConnect data provider](https://www.quantconnect.com/docs/v2/cloud-platform/datasets/quantconnect/crypto.md) provides Crypto data during live trading. Binance and Bybit restrict access from the United States, so you must use the Europe (WAW) [region](https://www.quantconnect.com/docs/v2/cloud-platform/live-trading/getting-started.md#07-Redundancy) to trade with them or to receive their data. To set the region, see [Deploy Live Algorithms](https://www.quantconnect.com/docs/v2/cloud-platform/live-trading/brokerages/bybit.md#16-Deploy-Live-Algorithms). ## Orders We model the Bybit API by supporting several order types, order properties, and order updates. When you deploy live algorithms, you can [place manual orders](https://www.quantconnect.com/docs/v2/cloud-platform/live-trading/algorithm-control.md#03-Place-Manual-Trades) through the IDE. ### Order Types The following table describes the available order types for each asset class that our Bybit integration supports: | Order Type | Crypto | Crypto Futures | | --- | --- | --- | | [Market](https://www.quantconnect.com/docs/v2/writing-algorithms/trading-and-orders/order-types/market-orders.md) | ![green check](https://cdn.quantconnect.com/i/tu/check.png) | ![green check](https://cdn.quantconnect.com/i/tu/check.png) | | [Limit](https://www.quantconnect.com/docs/v2/writing-algorithms/trading-and-orders/order-types/limit-orders.md) | ![green check](https://cdn.quantconnect.com/i/tu/check.png) | ![green check](https://cdn.quantconnect.com/i/tu/check.png) | | [Stop market](https://www.quantconnect.com/docs/v2/writing-algorithms/trading-and-orders/order-types/stop-market-orders.md) | ![green check](https://cdn.quantconnect.com/i/tu/check.png) | ![green check](https://cdn.quantconnect.com/i/tu/check.png) | | [Stop limit](https://www.quantconnect.com/docs/v2/writing-algorithms/trading-and-orders/order-types/stop-limit-orders.md) | ![green check](https://cdn.quantconnect.com/i/tu/check.png) | ![green check](https://cdn.quantconnect.com/i/tu/check.png) | ### Order Properties We model custom order properties from the Bybit API. The following table describes the members of the `BybitBrokerageModel` object that you can set to customize order execution: | Property | Data Type | Description | Default Value | | --- | --- | --- | --- | | `time_in_force` | `TimeInForce` | A [TimeInForce](https://www.quantconnect.com/docs/v2/writing-algorithms/trading-and-orders/order-properties.md#03-Time-In-Force) instruction to apply to the order. The following instructions are supported: `DAY` `GOOD_TIL_CANCELED` `good_til_date` | `TimeInForce.GOOD_TIL_CANCELED` | | `post_only` | `bool` | A flag to signal that the order must only add liquidity to the order book and not take liquidity from the order book. If part of the order results in taking liquidity rather than providing liquidity, the order is rejected without any part of it being filled. This order property is only available for limit orders. | | | `reduce_only` | `bool/NoneType` | A flag to signal that the order must only reduce your current position size. For more information about this order property, see [Reduce-Only Order](https://www.bybit.com/en-US/help-center/s/article/What-is-a-Reduce-Only-Order) on the Bybit website. | | ### Updates We model the Bybit API by supporting [order updates](https://www.quantconnect.com/docs/v2/writing-algorithms/trading-and-orders/order-management/order-tickets.md#04-Update-Orders) for Crypto Future assets that have one of the following [order states](https://www.quantconnect.com/docs/v2/writing-algorithms/trading-and-orders/order-events.md#03-Order-States): - `OrderStatus.NEW` - `OrderStatus.PARTIALLY_FILLED` - `OrderStatus.SUBMITTED` - `OrderStatus.FILLED` In cases where you can't update an order, you can cancel the existing order and then create a new order with the desired arguments. For more information about this workaround, see the [Workaround for Brokerages That Don’t Support Updates](https://www.quantconnect.com/docs/v2/writing-algorithms/trading-and-orders/order-management/order-tickets.md#workaround-for-brokerages-that-dont-support-updates). ## Fees To view the Bybit trading fees, see the [Trading Fees Schedule](https://www.bybit.com/en/help-center/article/Trading-Fee-Structure) page on the Bybit website. To view how we model their fees, see [Fees](https://www.quantconnect.com/docs/v2/writing-algorithms/reality-modeling/brokerages/supported-models/bybit.md#06-Fees). ## Margin We model [buying power](https://www.quantconnect.com/docs/v2/writing-algorithms/reality-modeling/brokerages/supported-models/bybit.md#07-Buying-Power) and [margin calls](https://www.quantconnect.com/docs/v2/writing-algorithms/reality-modeling/margin-calls.md) to ensure your algorithm stays within the margin requirements. ## Slippage Orders through Bybit do not experience slippage in backtests. In Bybit paper trading and live trading, your orders may experience slippage. To view how we model Bybit slippage, see [Slippage](https://www.quantconnect.com/docs/v2/writing-algorithms/reality-modeling/brokerages/supported-models/bybit.md#05-Slippage). ## Fills QuantConnect fills market orders immediately and completely in backtests. In Bybit paper trading and live trading, if the quantity of your market orders exceeds the quantity available at the top of the order book, your orders are filled according to what is available in the order book. To view how we model Bybit order fills, see [Fills](https://www.quantconnect.com/docs/v2/writing-algorithms/reality-modeling/brokerages/supported-models/bybit.md#04-Fills). ## Settlements Trades settle immediately after the transaction To view how we model settlement for Bybit trades, see [Settlement](https://www.quantconnect.com/docs/v2/writing-algorithms/reality-modeling/brokerages/supported-models/bybit.md#08-Settlement). ## Security and Stability When you deploy live algorithms with Bybit, we don't save your credentials. ## Deposits and Withdrawals You can deposit and withdraw cash from your brokerage account while you run an algorithm that's connected to the account. We sync the algorithm's cash holdings with the cash holdings in your brokerage account every day at 7:45 AM Eastern Time (ET). ## Demo Algorithm The following algorithm demonstrates the functionality of the Bybit brokerage: ```python # Demonstrate Bybit brokerage functionality with an EMA crossover strategy. class BybitDemoAlgorithm(QCAlgorithm): def initialize(self) -> None: self.set_start_date(2024, 9, 1) self.set_end_date(2024, 12, 31) self.set_cash(100000) self.set_brokerage_model(BrokerageName.BYBIT, AccountType.CASH) self._symbol = self.add_crypto("BTCUSDT", Resolution.DAILY, Market.BYBIT).symbol self._fast = self.ema(self._symbol, 10, Resolution.DAILY) self._slow = self.ema(self._symbol, 50, Resolution.DAILY) def on_data(self, slice: Slice) -> None: if not self._slow.is_ready: return if self._fast.current.value > self._slow.current.value and not self.portfolio.invested: self.set_holdings(self._symbol, 1) elif self._fast.current.value < self._slow.current.value and self.portfolio.invested: self.liquidate() ``` ## Virtual Pairs All fiat and Crypto currencies are individual assets. When you buy a pair like BTCUSD, you trade USD for BTC. In this case, LEAN removes some USD from your portfolio [cashbook](https://www.quantconnect.com/docs/v2/writing-algorithms/portfolio/cashbook.md) and adds some BTC. The virtual pair BTCUSD represents your position in that trade, but the virtual pair doesn't actually exist. It simply represents an open trade. When you deploy a live algorithm, LEAN populates your cashbook with the quantity of each currency, but it can't get your position of each virtual pair. ## Deploy Live Algorithms You must have an available [live trading node](https://www.quantconnect.com/docs/v2/cloud-platform/organizations/resources.md#04-Live-Trading-Nodes) for each live trading algorithm you deploy. Follow these steps to deploy a live algorithm: 1. [Open the project](https://www.quantconnect.com/docs/v2/cloud-platform/projects/getting-started.md#02-View-All-Projects) you want to deploy. 2. Click the ![Lightning icon](https://cdn.quantconnect.com/i/tu/deploy-live-icon.png) **Deploy Live** icon. 3. On the Deploy Live page, click the **Brokerage** field and then click **Bybit Exchange** from the drop-down menu. 4. Enter your API key and secret. To generate your API credentials, see [Account Types](https://www.quantconnect.com/docs/v2/cloud-platform/live-trading/brokerages/bitfinex.md#02-Account-Types). Your account details are not saved on QuantConnect. 5. Click the **VIP Level** field and then click your level from the drop-down menu. For more information about VIP levels, see [FAQ — Bybit VIP Program](https://www.bybit.com/en/help-center/article/FAQ-VIP-Program) on the Bybit website. 6. Click on the **Environment** field and then click one of the environments. The following table shows the supported environments: | Environment | Description | | --- | --- | | Live | Trade with real money | | Demo | Trade with paper money through the [Bybit Demo Trading](https://www.bybit.com/en/help-center/article/FAQ-Demo-Trading) environment | | Testnet | Trade with paper money through the [Bybit Testnet](https://testnet.bybit.com/) | 7. In the **Region** section, click the [region](https://www.quantconnect.com/docs/v2/cloud-platform/live-trading/getting-started.md#07-Redundancy) where you want to run the algorithm. Binance and Bybit restrict access from the United States, so you must use the Europe (WAW) [region](https://www.quantconnect.com/docs/v2/cloud-platform/live-trading/getting-started.md#07-Redundancy) to trade with them or to receive their data. 8. Click the **Node** field and then click the live trading node that you want to use from the drop-down menu. 9. (Optional) In the **Data Provider** section, click **Show** and change the data provider or add additional providers. 10. If your brokerage account has existing position holdings, follow these steps ([see video](https://vimeo.com/703024505)): 1. In the **Algorithm Holdings State** section, click **Show**. 2. Click **Add Holding**. 3. Enter the symbol ID, symbol, quantity, and average price. 11. (Optional) [Set up notifications](https://www.quantconnect.com/docs/v2/cloud-platform/live-trading/notifications.md). 12. Configure the **Automatically restart algorithm** setting. By enabling [automatic restarts](https://www.quantconnect.com/docs/v2/cloud-platform/live-trading/deployment.md#07-Automatic-Restarts), the algorithm will use best efforts to restart the algorithm if it fails due to a runtime error. This can help improve the algorithm's resilience to temporary outages such as a brokerage API disconnection. 13. Click **Deploy**. The deployment process can take up to 5 minutes. When the algorithm deploys, the [live results page](https://www.quantconnect.com/docs/v2/cloud-platform/live-trading/results.md) displays. If you know your brokerage positions before you deployed, you can verify they have been loaded properly by checking your equity value in the runtime statistics, your cashbook holdings, and your position holdings. Restarts, including automatic restarts and redeployments, don't save the state of your algorithm. To learn what a restart recovers and how to persist the rest, see [State Persistence](https://www.quantconnect.com/docs/v2/cloud-platform/live-trading/deployment.md#10-State-Persistence). ## Deployment Details When you deploy a live algorithm with Bybit, the brokerage shares some details of the deployment, like the account it trades. Use them to tell concurrent deployments apart or to check that the algorithm connected to the account you expect. The details never include credentials. The following table describes the deployment details that Bybit shares: | Key | Description | | --- | --- | | `bybit-vip-level` | The VIP level of the account, which sets the API rate limits. For example, `VIP0`. | The `deployment_details` property of your algorithm is a read-only dictionary of the details. LEAN populates it before it calls the `initialize` method, so you can read it anywhere in your algorithm. ```python deployment_details = [f'{kvp.key}:{kvp.value}' for kvp in self.deployment_details] self.log(f'deployment_details: {deployment_details}') ``` The [/live/read](https://www.quantconnect.com/docs/v2/cloud-platform/api-reference/live-management/read-live-algorithm/live-algorithm-statistics.md) API endpoint also returns the details in its `deploymentDetails` field, so you can read them outside of the algorithm. ## Troubleshooting The following table describes errors you may see when deploying to Bybit: | Error Message(s) | Possible Cause and Fix | | --- | --- | | Invalid API-key, IP, or permissions for action. | The credentials you provided are incorrect. Typically, the API key and API Secret contains leading and/or trailing white spaces. Copy the API key and API Secret to a text editor to ensure their are correct. Your API keys do not have read-write permissions. For more information, see [Account Types](https://www.quantconnect.com/docs/v2/cloud-platform/live-trading/brokerages/bybit.md#02-Account-Types). | | You haven't enabled Cross Margin Trading yet. | Your account uses isolated margin. To enable cross margin, please head to the PC trading site or the Bybit app. For more information, see [Isolated Margin/Cross Margin](https://www.bybit.com/en/help-center/article/What-is-Isolated-Margin-Cross-Margin). | If you need further support, [open a new support ticker](https://www.quantconnect.com/docs/v2/cloud-platform/organizations/support.md#06-Open-New-Tickets) and add the live deployment with the error.