# VOOI\_LIGHT:operationalGuidelines

## Getting Started with VOOI Light

{% hint style="info" %}
**VOOI Light Beta**

* Enables trading via KiloEx, GMX, and Ostium
* **Spot trading** available across: Arbitrum, Base, BNB Smart Chain, OP Mainnet, Polygon, Linea, Ethereum, and Solana
* **Perpetual trading** available across: Arbitrum, Base, and BNB Smart Chain
* More supported chains and perpetual DEXs coming soon
  {% endhint %}

{% hint style="info" %}
If you have any questions or encounter any issue, please contact [our team on Discord](https://discord.com/invite/KhAzSuV5Wx)
{% endhint %}

VOOI Light provides a next-generation trading experience through a Chain Abstraction layer, enabling interaction with DeFi protocols across multiple blockchains. Users initiate all actions and retain full control over their assets and private keys.

This guide outlines the basic workflow for using VOOI Light.

**Overview of Workflow:**

1. Log in to VOOI Light
2. Connect other login options (this step is optional but highly recommended)
3. Add funds
4. Start trading
5. Manage your funds through VOOI Light portfolio interface

***

## Workflow

### 1. Log In to VOOI Light

Open VOOI Light (the beta version) at <https://app.vooi.io/>, click **Log In**, and choose the authentication method that works best for you from the available options:\
![](https://3071033198-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXCba6CdwFKbzdASxvC5H%2Fuploads%2FdOxDhNBbuqJIja2ihJQ2%2Fimage.png?alt=media\&token=d986ccd7-62f8-49df-92ca-ccd7603b46c8)

Follow the on-screen instructions to complete the login process.

When you log in to VOOI Light for the first time, a unique smart-contract wallet address is created for you. Only you can access and control assets on this address across supported blockchain networks. VOOI never has access to your funds or private keys.

***

### 2. Connect Other Login Options (Linked Accounts)

By linking accounts, you add alternative login options to your VOOI Light account. This ensures that even if you lose access to the email you used to register or your passkey is lost, you’ll still be able to log in.

{% hint style="info" %}
**Important:** We strongly recommend connecting at least one additional login method for account recovery.
{% endhint %}

To connect a login option:

1. After logging in, click your account balance in the top right corner and then click the **Linked Account** icon:\
   ![](https://3071033198-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXCba6CdwFKbzdASxvC5H%2Fuploads%2FvuJX3YohhknvRw8cBbCy%2Fimage.png?alt=media\&token=1a6f6739-d4ed-40f1-aed9-5b8b94583f67)
2. In the **Linked Accounts** section, press the **Connect** button next to your preferred login method (Passkey, Google, Telegram, etc.). Follow the on-screen instructions to complete the connection process.\
   ![](https://3071033198-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXCba6CdwFKbzdASxvC5H%2Fuploads%2FWjMjvfYtGRCkubO8jKVE%2Fimage.png?alt=media\&token=7a1513e3-7e01-4380-b6aa-e48dd45846a2)
3. Repeat the process if you'd like to add more login options.

***

### 3. Add Funds

Each VOOI Light account is associated with a unique EVM smart-contract wallet address and with a unique Solana smart-contract wallet address. When you send tokens to one of this addresses on a supported blockchain, they are reflected in your total equity balance within the app interface:

* If you send **USDT** or **USDC**, the funds will automatically be available in your unified trading balance.
* If you send any other token on a supported network, it will appear under your asset balance.

These balances visually represent the tokens held at your wallet address on supported blockchains. All operations – including trading and fund transfers – are initiated by you and remain fully under your control.

{% hint style="info" %}
For more details about how balances work, see [#id-4.-vooi-v2-portfolio-fund-management](#id-4.-vooi-v2-portfolio-fund-management "mention")
{% endhint %}

**Important note 1:** If you’re depositing funds for the first time, we recommend using **USDT** or **USDC**, as these tokens are also used to settle transaction fees for trading and asset management.

**Important note 2:** A portion of your deposited funds, equivalent to 10 USD, is reserved to cover transaction fees for your operations. This amount remains fully withdrawable at any time.

Once your balance is topped up, you can trade and move funds without directly paying gas fees – all actions are processed through your smart-contract wallet.

#### Steps to top up your account balance:

1. After logging in, click Deposit:\
   ![](https://3071033198-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXCba6CdwFKbzdASxvC5H%2Fuploads%2FkKjOaAHOi3aCJHNZY8hK%2Fimage.png?alt=media\&token=add59b6c-3b6c-44e4-940f-262c89f270f8)
2. \>> If you logged in with a wallet and want to top up your balance from the connected wallet, select the **Wallet** option.\
   \>> If you logged in using another method or want to send from a different wallet, select **Receive Funds**.\
   ![](https://3071033198-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXCba6CdwFKbzdASxvC5H%2Fuploads%2F0TrxjR6P9BovCIQQrfuf%2Fimage.png?alt=media\&token=cea91062-0227-4e0b-93fa-ff95680bf3a7)
3. When you choose **Receive Funds**, you’ll see the unique **smart-contract wallet address** associated with your VOOI Light account. Copy or scan this address to send tokens on any supported blockchain:\
   ![](https://3071033198-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXCba6CdwFKbzdASxvC5H%2Fuploads%2Fug6d8GSd1MZcrlWSe4yA%2Fimage.png?alt=media\&token=024968f0-61dc-4526-9ce1-7692632c867b)
4. Once the transaction is signed, broadcast, and confirmed on-chain, the VOOI Light interface reflects this automatically:\
   ![](https://3071033198-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXCba6CdwFKbzdASxvC5H%2Fuploads%2Fxft2HYGIyg2Pwu6u686b%2Fimage.png?alt=media\&token=1af0d0eb-576a-470b-ad09-c7bfa061289e)

**Important:**  A portion of your deposited funds, equivalent to 10 USD, is reserved to cover transaction fees for your operations. This amount remains fully withdrawable at any time.

***

### 4. Trade

VOOI Light beta currently supports trading on the perpetual **KiloEx,** **GMX** and **Ostium**, with more integrations coming soon.

⚠️ Features shown as **greyed out** in the VOOI Light terminal will become available shortly.

#### Choosing Chart Type

Before you start trading, you may want to customize how price data is displayed.\
To change the chart type, click the **chart style icon:**\
![](https://3071033198-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXCba6CdwFKbzdASxvC5H%2Fuploads%2FP3xlHEsUuRVM52LeiOXT%2Fimage.png?alt=media\&token=b831e260-1a82-46db-a19a-836974325bab)\
Then select your preferred option:

* **Candles (default)** – the most common format, showing open, high, low, and close (OHLC)
* **Bars**, **HLC Bars**, **Hollow Candles** – alternative OHLC visualizations
* **Line**, **Step Line**, **Line with markers** – simplified representations of price trends
* **Area**, **HLC Area**, **Baseline** – useful for quick visual comparisons

Adjusting the chart type helps align the view with your trading style and analytical needs.

#### Trading Workflow:

1. **Select a trading pair** from the list on the left side of the terminal. For example, BTC/USD:\
   ![](https://3071033198-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXCba6CdwFKbzdASxvC5H%2Fuploads%2FuE1tTtAxBSYELt4fVj8a%2Fimage.png?alt=media\&token=e0cd6d0f-7ffb-4154-87b3-7e8547283bae)
2. **Set your position parameters** on the right panel:\
   ![](https://3071033198-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXCba6CdwFKbzdASxvC5H%2Fuploads%2F62L8MWH35hsOv25Cen1z%2Fimage.png?alt=media\&token=a637436a-09f9-46e7-bcb8-01b0746fd9a4)
3. &#x20;(1) Choose **Long** or **Short**\
   &#x20;(2) Check the current amount available for trading; if needed, deposit more\
   &#x20;(3) Select **Leverage**\
   &#x20;(4) Specify **Position Size**\
   &#x20;(5) Request Quotes\
   ![](https://3071033198-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXCba6CdwFKbzdASxvC5H%2Fuploads%2FuZlMlBdqH2AmTMSabXrZ%2Fimage.png?alt=media\&token=1a3df66c-0423-46c9-89d5-996ce93abf60)
4. You’ll receive quotes from all supported protocols that can fill your order size. \
   For example, you may see offers from KiloEx on Base and BNB Chain. If the requested size is too small for a certain venue (e.g., Ostium on Arbitrum), it may not return a quote.\
   ![](https://3071033198-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXCba6CdwFKbzdASxvC5H%2Fuploads%2F7YVrX5wKAkWiW9aKj3Re%2Fimage.png?alt=media\&token=3e9b6e04-8ecf-4410-966f-851e06e9dd1b)
5. The best offer is preselected by default. You can either leave it or select another quote from the list. Then, click **Open** to place your order:\
   ![](https://3071033198-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXCba6CdwFKbzdASxvC5H%2Fuploads%2F3tnXyoOEMvgSWfqXwor0%2Fimage.png?alt=media\&token=967ede36-3412-443b-99de-1fd8b09220a7)
6. You can view your open positions in the **Positions** tab of the trading terminal:\
   ![](https://3071033198-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXCba6CdwFKbzdASxvC5H%2Fuploads%2FiEttZaityOg8FDw3DYDT%2Fimage.png?alt=media\&token=f4013e8e-f525-4015-84b1-8dffc163ce6b)
7. To close a position, click **Close** next to the position. Then, specify the closing parameters on the next screen and confirm the operation:\
   ![](https://3071033198-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXCba6CdwFKbzdASxvC5H%2Fuploads%2F5TXyZau12hftSE6mRmOW%2Fimage.png?alt=media\&token=c57c36ed-84c5-4d58-a172-24bfcdf459b6)
8. Your trade history is available in the **History** tab:\
   ![](https://3071033198-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXCba6CdwFKbzdASxvC5H%2Fuploads%2Fh7bkpOON7ULoFY432xJh%2Fimage.png?alt=media\&token=873a055e-2db6-4617-a855-eb9e1c31c17e)

#### Flow of Assets when Trading

{% hint style="info" %}
Make sure to get familiar with your **Portfolio** – a unified view and control center for your funds: [#id-4.-vooi-v2-portfolio-funds-management](#id-4.-vooi-v2-portfolio-funds-management "mention")
{% endhint %}

Your **unified trading balance** includes assets supported for trading (USDT/USDC) held across supported networks and is used automatically for opening and closing positions, covering trading fees, and gas.&#x20;

**Example**\
USDC on Base + USDT on BNB = a single balance available for trading on any supported chain:

1. The account was initially funded with USDC on **Base**:\
   ![](https://3071033198-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXCba6CdwFKbzdASxvC5H%2Fuploads%2FLJtivPiBDkPlXYfzd1N6%2Fimage.png?alt=media\&token=5aa69e86-979a-495a-bbfa-87aaa94340f3)
2. A position was then opened on **BNB Chain**.
3. When the position was closed, the funds were sent to your address on **BNB Chain** and reflected in your **unified trading balance**:\
   ![](https://3071033198-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXCba6CdwFKbzdASxvC5H%2Fuploads%2FhTly1bS6cgMS1RqOrIsS%2Fimage.png?alt=media\&token=5155040e-9894-4665-8406-70f51cb041d1)

***

### 5. Portfolio (Fund Management)

**Portfolio** is a unified view and control center for your funds. It shows your balances, asset distribution, trading allocations, stocks, points and provides key actions like **deposit**, **send**, or **swap** – all in one place.

After logging in, click **Portfolio** in the top right corner to open it:

<figure><img src="https://3071033198-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXCba6CdwFKbzdASxvC5H%2Fuploads%2FMsLAT5HSpYGiJs3Nw5dZ%2Fimage.png?alt=media&#x26;token=e17dde1f-0172-4d25-91e4-682161b36466" alt=""><figcaption></figcaption></figure>

#### **(1) Total Equity**

This is your total account value in USD – including funds available for trading (available margin), funds currently in use as margin, funds allocated to cover gas fees and idle assets. It reflects all supported tokens across chains, based on current market prices.

#### **(2) Unified Trading**

This is your trading balance – the portion of your total equity available for trading, managing positions, and covering gas fees. It includes supported assets (USDT and USDC) across all supported networks and is automatically used when opening or closing positions.

The Unified Balance is divided into:

* **Available Margin**\
  The amount currently free and available for opening new positions.
* **Fee Reserve**\
  A portion of deposited funds, equivalent to 10 USD, is reserved and used to pay gas fees for trading operations and fund management, including swaps and fund transfers. This amount remains fully withdrawable at any time.
* **Margin-in-Use** \
  Funds currently locked in open positions. These become available again when positions are closed. To review open positions and their PnL, click the Merging-in-Use. You will then be redirected to the **Trading Terminal**. Under the **Positions** tab, you can review open positions.

**Notes:**

* **NB 1** See the breakdown by token and network in the **Unified Trading** tab below.
* **NB 2** Assets that cannot be used for trading (e.g., BNB, ETH, etc.) are not included in this balance. These assets can be reviewed under the **Crypto** tab below:\
  ![](https://3071033198-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXCba6CdwFKbzdASxvC5H%2Fuploads%2FL5Hi2sxIqjI4T9AMfuN1%2Fimage.png?alt=media\&token=440dbf2b-6aa8-47eb-8213-d92cea96924d)\
  \
  To use these assets for trading, simply swap them into USDC or USDT. It can be done within your VOOI Light account in the [Swap](https://app.vooi.io/portfolio/swap) section.

#### **(3) Quick Actions**

Shortcuts to manage your funds:

* **Deposit**: Add funds to your VOOI Light account
* **Send**: Send tokens from your VOOI Light account
* **Swap**: Swap between supported tokens and networks within your VOOI Light account

#### (4) Statistics

The **Statistics** section displays your trading metrics: volumes and PnL for derivatives, as well as swap activity (all swaps, cross-chain, and on-chain) over 24h and in total.

***

## Rebalancing

In some cases, to **open a position** or **execute an order**, it is necessary to aggregate tokens on the execution network.

If you see the message: **Rebalancing required: aggregate tokens on the execution network**, follow these steps:

1. Go to **Portfolio**.
2. Expand **USDT** token for **KiloEx** and **USDC** token for **any other** perpetual DEX or trading platform.
3. Enable the **Show All** checkbox to display tokens on all networks and click **Aggregate** next to the network where you want to execute the trade:\
   ![](https://3071033198-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXCba6CdwFKbzdASxvC5H%2Fuploads%2FzIxONxWQu3K7ixWF6bx8%2Fimage.png?alt=media\&token=07d1b2e3-b5c7-4418-a56e-201f5432e649)

This will consolidate your tokens on that network, allowing you to complete the action without interruptions.

***

## Re-linking Login Options

{% hint style="info" %}
**Important:** Points cannot be transferred or consolidated between VOOI accounts.
{% endhint %}

If you want to use a login option (for example, a wallet) on another VOOI Light account, or you see a warning such as: **Authentication failed; This account has already been linked to another person**,\
you may need to re-link your login method.

Below is a simple walkthrough on how to re-link a login option between VOOI Light accounts:

1. Log in with the login option you want to relink at: [https://app.vooi.io/](https://app.vooi.io/\))
2. Add an additional login option that you don’t use for VOOI Light (for example, if you logged in with a wallet, you can temporarily link Google or Telegram).\
   ![](https://3071033198-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXCba6CdwFKbzdASxvC5H%2Fuploads%2FIKkYfdt7zgz51cDTu5x8%2Fimage.png?alt=media\&token=a9002667-555a-4137-91b0-cd09ba0f79af)
3. Unlink the login option you want to move to another VOOI Light account.
4. Log out:\
   ![](https://3071033198-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXCba6CdwFKbzdASxvC5H%2Fuploads%2FJgclGjXGzhBqqlKwHIvM%2Fimage.png?alt=media\&token=858a9866-aac6-46a8-92dd-6ebc03a508d8)
5. Log in to your main VOOI Light account: the one where you want all your login methods to be linked: [https://app.vooi.io/](https://app.vooi.io/\))
6. Link the login option that you disconnected in Step 3 to this main account.

***

## Getting Support

If you have any questions or encounter any issue, please contact [our team on Discord](https://discord.com/invite/KhAzSuV5Wx)
