> For the complete documentation index, see [llms.txt](https://docs.vooi.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.vooi.io/vooi-ultra-v3/ultra-operational-guidelines/connect-bybit-futures-to-vooi-ultra.md).

# Connect Bybit Futures to VOOI Ultra

This guide explains how to connect a Bybit account to VOOI Ultra using an API key.

You can connect either:

* Your **Bybit Main Account**;
* A dedicated **Bybit Subaccount**.

Once connected, you can trade supported Bybit markets through VOOI Ultra.

### Before You Start

Make sure that:

* Your Bybit account is ready for trading;
* The account has access to **Unified Trading**;
* The account has sufficient funds available for trading.

You will also need to create a Bybit API key and add the required VOOI Ultra IP addresses.

## Use Bybit Main Account

Use this section if you want to connect your Bybit Main Account directly to VOOI Ultra and trade using its Unified Trading balance.

### Create a Bybit API Key for Main Account

1. Log in to Bybit at <https://www.bybit.com/>.
2. Go to **API Management**.
3. Click **Create New Key**.
4. Select **System-generated API Keys**.
5. For **API Key Usage**, select **API Transaction**.
6. Enter a name for the API key.\
   Example: `VOOI Ultra`

<figure><img src="https://3071033198-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXCba6CdwFKbzdASxvC5H%2Fuploads%2FveVbCzsXXWehJHYHxs8p%2Fimage.png?alt=media&amp;token=23005e57-e836-4739-b7b0-bc8642caf1b2" alt="" width="455"><figcaption></figcaption></figure>

7. Under **API Key Permissions**, select **Read-Write**.
8. Select **Only IPs with permissions granted are allowed to access the OpenAPI**.
9. Enter the following VOOI Ultra IP addresses, separated by commas:

   ```
   35.78.12.245,54.249.80.55,52.68.244.92,13.159.166.194,13.112.74.148,52.192.115.1,52.192.68.116,13.193.138.71,57.181.0.148,13.115.147.66
   ```
10. Under **Unified Trading**, enable:
    1. **Orders**
    2. **Positions**
    3. **USDC Derivatives Trading**
    4. **Trade** under Spot
11. Under **Assets → Wallet**, enable **one** of the following permissions:
    1. **Account Transfer** (recommended)
    2. **Subaccount Transfer**&#x20;
    3. **Withdrawal**\
       \
       **Important:** Only one of these permissions is required. We recommend **Account Transfer** as the least sensitive option for this setup.<br>
12. Leave other permissions disabled unless you need them for another purpose.
13. Click **Submit**.
14. Complete the required Bybit security verification if prompted.
15. Copy the **API Key** and **Secret Key** before closing the confirmation window.

{% hint style="info" %}
**Important:** Save the **Secret Key** when it is displayed. It may not be available again later.
{% endhint %}

#### Additional Market Agreements

Bybit requires additional agreements to trade certain markets through Subaccounts.

There are two separate agreements:

* One for **stocks, ETFs, and metals**;
* One for **oil**.

Only the agreement required for the markets you want to trade needs to be accepted.

The agreement is accepted on the **Bybit Main Account** and then applies to eligible Subaccounts under that Main Account.

If you connect your **Main Account** to VOOI, VOOI can handle the agreement through the Main Account API key. For this, the API key must have at least one of the following permissions enabled:

* **Account Transfer** — recommended
* **Subaccount Transfer**
* **Withdrawal**

Only **one** of these permissions is required.

If you connect a **Subaccount** to VOOI, VOOI only uses the API key created for that Subaccount and cannot accept the agreement on the Main Account. In this case, accept the required agreement directly on Bybit using the **Main Account**.

### Connect the Main Account to VOOI Ultra

<figure><img src="https://3071033198-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXCba6CdwFKbzdASxvC5H%2Fuploads%2FcdnhnZSPMCKA5HMhiHfk%2Fimage.png?alt=media&amp;token=11413e20-9787-4129-a77a-38ada2eeef46" alt="" width="563"><figcaption></figcaption></figure>

1. Open VOOI Ultra at <https://ultra.vooi.io/>.
2. Select **Bybit**.
3. Enter the **API Key** and **Secret Key** created on Bybit.
4. Enable trading.

Once the API key is connected and the account has sufficient funds, you can trade supported Bybit markets through VOOI Ultra.

***

## Use Bybit Subaccount

Use this section if you want to keep VOOI Ultra trading separate from your Main Account by using a dedicated Bybit Subaccount.

### Create a Bybit Subaccount

<figure><img src="https://3071033198-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXCba6CdwFKbzdASxvC5H%2Fuploads%2FCEetfSHY6YOGM18YQ3m2%2Fimage.png?alt=media&amp;token=3cfe2f8b-1931-46b1-83a2-ff21b57b5d66" alt=""><figcaption></figcaption></figure>

1. Log in to your Bybit Main Account at <https://www.bybit.com/>.
2. Go to **Subaccount**.
3. Click **Create Subaccount**.
4. Select **Standard Account:**
   1. **Standard Account is recommended for VOOI.** It provides access to the Subaccount interface and its settings.
   2. **Custodial Account** is designed for delegated asset management, while&#x20;
   3. **Islamic Account** has a more limited set of available products.
5. Enter a nickname for the Subaccount.
6. Optionally, create login credentials if you want to log in to the Subaccount directly.
7. Create the Subaccount.

Once created, the Subaccount will appear in your Subaccount list.

You can use **Switch** to open the Subaccount or **Transfer** to move funds to it.

***

### Fund the Subaccount

Transfer the funds you want to use for trading to the Subaccount’s **Unified Trading** balance.

1. From the Bybit Main Account, open **Subaccount**.
2. Find the Subaccount you want to fund.
3. Click **Transfer**.
4. Select the Main Account as the source.
5. Select the Subaccount as the destination.
6. Select **Unified Trading** for the Subaccount.
7. Select the asset and enter the amount.
8. Confirm the transfer.

You can also fund the Subaccount later.

Because Bybit uses Unified Trading, there is no separate Spot → Futures transfer step.

### Create a Bybit API Key for Subaccount

1. From the Subaccount list, click **Switch** for the Subaccount you want to connect.
2. You will be taken to the Subaccount interface.
3. Open **API Management**.
4. Click **Create New Key**.
5. Complete Bybit security verification if prompted.
6. Return to **API Management** and click **Create New Key** again if required.
7. Select **System-generated API Keys**.
8. For **API Key Usage**, select **API Transaction**.

<figure><img src="https://3071033198-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXCba6CdwFKbzdASxvC5H%2Fuploads%2FRYW5BJXMd9kriEGih91j%2Fimage.png?alt=media&amp;token=b57efa75-b381-4393-9d94-b01bb6f51cba" alt="" width="563"><figcaption></figcaption></figure>

9. Enter a name for the API key.\
   Example: `VOOI Ultra`
10. Under **API Key Permissions**, select **Read-Write**.
11. Select **Only IPs with permissions granted are allowed to access the OpenAPI**.
12. Enter the following VOOI Ultra IP addresses, separated by commas:

    ```
    35.78.12.245,54.249.80.55,52.68.244.92,13.159.166.194,13.112.74.148,52.192.115.1,52.192.68.116,13.193.138.71,57.181.0.148,13.115.147.66
    ```
13. Under **Unified Trading**, enable:
    1. **Orders**
    2. **Positions**
    3. **USDC Derivatives Trading**
    4. **Trade** under Spot
14. No additional permissions under **Assets → Wallet** are required for the Subaccount API key.
15. Leave the additional agreement permissions disabled unless they are specifically required.
16. Click **Submit**.
17. Complete any additional security verification if prompted.
18. Copy the **API Key** and **Secret Key** before clicking **Understood** or closing the confirmation window.

{% hint style="info" %}
**Important:** Save the **Secret Key** when it is displayed. It may not be available again later.
{% endhint %}

### Connect the Subaccount to VOOI Ultra

<figure><img src="https://3071033198-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXCba6CdwFKbzdASxvC5H%2Fuploads%2FTPL0sKz1v3WZK4NS3ghx%2Fimage.png?alt=media&amp;token=8324952c-ee39-4ac7-a986-50f6c7601462" alt="" width="563"><figcaption></figcaption></figure>

1. Open VOOI Ultra at <https://ultra.vooi.io/>.
2. Select **Bybit**.
3. Enter the Subaccount **API Key** and **Secret Key**.
4. Enable trading.

Once the API key is connected, the Bybit Subaccount becomes available in VOOI Ultra.

Trading activity through this connection uses the funds and positions of that Subaccount.

### Deposits and Withdrawals

For a Bybit Subaccount, move funds between the Main Account and Subaccount using Bybit’s internal **Transfer** function.

Use the Subaccount’s **Unified Trading** balance for trading through VOOI Ultra.

For Main Account deposits and external withdrawals, use Bybit directly.