> 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/arbitrage-bots.md).

# Arbitrage Bots

VOOI Arbitrage Bots automate delta-neutral strategies across supported venues.

## Overview

<figure><img src="https://3071033198-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXCba6CdwFKbzdASxvC5H%2Fuploads%2F3yr8PbPdpQN5CFwELLn9%2Fimage.png?alt=media&amp;token=f59db0cf-ba1e-438e-9f57-715fef17beeb" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
VOOI Delta-Neutral Arbitrage Bots: <https://ultra.vooi.io/bots>
{% endhint %}

VOOI Ultra **Arbitrage Bots** automate delta-neutral strategies across supported venues.

A bot opens a **long position on one venue and a short position on another for the same asset**. Holding opposite positions helps reduce exposure to the asset’s overall price direction while the bot follows the selected goal.

Users can choose which venues and markets the bot can use, control the direction for each venue, set the margin for each leg, and select a goal that determines how the bot manages the strategy.

Up to **20 bots per account** can run at the same time.

{% hint style="info" %}
**Arbitrage Bots are designed for automated strategy search and execution.**

For manual strategy selection and trading, use **Arbitrage Desk**.

Learn more in [VOOI Arbitrage Desk](/vooi-ultra-v3/vooi-arbitrage-desk.md)
{% endhint %}

## How Arbitrage Bots Work

Every minute, the bot checks eligible pairs based on the selected venues, directions, markets, and strategy settings.

When an eligible pair is found, the bot opens a **long position on one venue and a short position on another for the same asset**.

One leg is placed as a resting **Limit order**.

Once the pair is open, the bot manages both legs according to the selected goal and configured rules.

After the pair is closed, the bot can start searching for another eligible pair.

Stopping the bot also closes its current pair.

## Create an Arbitrage Bot

{% hint style="info" %}
At least two compatible venues with trading enabled and sufficient funds are required.
{% endhint %}

<figure><img src="https://3071033198-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXCba6CdwFKbzdASxvC5H%2Fuploads%2FZHElx0XVhSc6nnaCpPig%2Fimage.png?alt=media&amp;token=d05ae5c8-99ee-4c51-ab9e-6c759302f61d" alt="" width="563"><figcaption></figcaption></figure>

Open **Arbitrage Bots** in VOOI Ultra at <https://ultra.vooi.io/bots>, connect your wallet and click **Create a bot**.

### Step 1: Choose venues

<div align="left"><figure><img src="https://3071033198-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXCba6CdwFKbzdASxvC5H%2Fuploads%2FyDygEzJrJFVFsMK4kFCu%2Fimage.png?alt=media&amp;token=67c12671-4d0b-49cf-a762-e9387d2bb113" alt="" width="563"><figcaption></figcaption></figure></div>

For each venue, choose a direction:

* **Any:**  the venue can be used for either side;
* **Long:** the venue can only be used for the Long leg;
* **Short:** the venue can only be used for the Short leg.

This makes it possible to create direction-sensitive strategies.\
\
**Tip:** Bots require at least two venues with trading enabled and sufficient funds available.

### Step 2: Select markets

<div align="left"><figure><img src="https://3071033198-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXCba6CdwFKbzdASxvC5H%2Fuploads%2FichUzAD8aJzze48Pjkbt%2Fimage.png?alt=media&amp;token=c6daf053-8a58-4738-8250-00e3b4b07a08" alt="" width="563"><figcaption></figcaption></figure></div>

Choose which markets the bot can use.

Markets can be selected in two ways:

* **Asset classes:** select entire market categories;
* **Coins:** select up to **20 individual markets**.

The available list includes only markets that can be paired using the venues and directions selected in Step 1.

### Step 3: Size each pair

<div align="left"><figure><img src="https://3071033198-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXCba6CdwFKbzdASxvC5H%2Fuploads%2FN1XYRpw4XqKwEEAbX11H%2Fimage.png?alt=media&amp;token=b939819c-7ad5-407d-ae74-859295be5202" alt="" width="563"><figcaption></figcaption></figure></div>

Set the **Margin per venue** for each leg of the pair.

The selected goal determines the leverage used by the bot, which in turn determines the resulting position size.

Margin remains on the corresponding trading venue.

### Step 4: Pick a goal

<div align="left"><figure><img src="https://3071033198-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXCba6CdwFKbzdASxvC5H%2Fuploads%2FsGiPq7wl36EljyshOVUZ%2Fimage.png?alt=media&amp;token=a0b23391-bc42-49d8-a7d8-444ced49f398" alt="" width="563"><figcaption></figcaption></figure></div>

#### **4.1. Goal**

Choose how the bot should manage the strategy:

* **Earn Funding** is designed to target sustained funding opportunities.
  * The preset waits for sustained positive funding and can hold a pair for up to **14 days** at up to **5x leverage**.
* **Hold Open Interest** is designed to keep a hedged position open and maintain open interest.
  * The preset can keep a pair open for up to **2 days** at up to **10x leverage**, and exits when funding stops paying over the day.
* **Trade Volume** is designed to generate trading volume by opening and closing hedged positions more frequently.
  * The preset uses up to **20x leverage** and closes a pair at break even or after approximately **5 minutes**, then searches for another eligible pair.

#### **4.2. Rules**

Selecting a goal automatically sets the rules below. Any of them can be changed to tune the strategy.

**Entering**

<div align="left"><figure><img src="https://3071033198-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXCba6CdwFKbzdASxvC5H%2Fuploads%2FiWn3aYiIqiF1yMhx0taf%2Fimage.png?alt=media&amp;token=88907748-745e-4092-930f-956084a3f5f1" alt="" width="563"><figcaption></figcaption></figure></div>

* **Funding rule** determines how long the Funding Spread must remain positive before the bot can enter a pair. Set it to **Off** if positive funding should not be required.
* **Cost limit** sets the maximum estimated cost allowed to open and close a pair.
* **Profit floor** requires expected funding over the holding period to exceed estimated trading costs by the selected amount. Can be set to **Off**.

**Holding**

<div align="left"><figure><img src="https://3071033198-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXCba6CdwFKbzdASxvC5H%2Fuploads%2Fc1dZ4vxefJ6YhYvMHoeS%2Fimage.png?alt=media&amp;token=f639dbcf-c4db-4365-b236-9062b09383c8" alt="" width="563"><figcaption></figcaption></figure></div>

* **Max leverage** sets the maximum leverage for the pair.
* **Max hold** sets how long the bot normally keeps a pair open.
* **Extend max hold** allows the bot to keep the pair open beyond Max hold when it would otherwise close and reopen the same opportunity, avoiding unnecessary trading fees.

**Exiting**

<div align="left"><figure><img src="https://3071033198-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXCba6CdwFKbzdASxvC5H%2Fuploads%2F6g3Mo2V5k1HFYeZICvMx%2Fimage.png?alt=media&amp;token=92c96c7d-e7fe-42fa-860e-bfc6c215c887" alt="" width="563"><figcaption></figcaption></figure></div>

* **Exit each pair at** sets an additional exit target: **Off**, **Break even**, or **Profit**.
* **Exit before liquidation** closes the pair before either leg gets too close to liquidation. The selected percentage determines how far toward liquidation the position can move.
* **Cooldown between pairs** sets how long the bot waits after closing a pair before looking for the next one: **Off**, **Fixed**, or **Random**.

**The default rules for each goal are:**

<table data-search="false"><thead><tr><th width="223"></th><th>Earn Funding</th><th>Hold Open Interest</th><th>Trade Volume</th></tr></thead><tbody><tr><td><strong>Funding rule</strong></td><td>12h</td><td>6h</td><td>Off</td></tr><tr><td><strong>Cost limit</strong></td><td>Flexible 0.40%</td><td>Balanced 0.25%</td><td>Balanced 0.25%</td></tr><tr><td><strong>Profit floor</strong></td><td>0.10%</td><td>Off</td><td>Off</td></tr><tr><td><strong>Max leverage</strong></td><td>5x</td><td>10x</td><td>20x</td></tr><tr><td><strong>Max hold</strong></td><td>14 days</td><td>2 days</td><td>5 min</td></tr><tr><td><strong>Extend max hold</strong></td><td>On</td><td>Off</td><td>Off</td></tr><tr><td><strong>Exit each pair at</strong></td><td>Off</td><td>Off</td><td>Break even</td></tr><tr><td><strong>Exit before liquidation</strong></td><td>On: 90%</td><td>On:90%</td><td>On: 85%</td></tr><tr><td><strong>Cooldown between pairs</strong></td><td>Off</td><td>Random 5–10 min</td><td>Random 1–2 min</td></tr></tbody></table>

The preset is a starting configuration. Changing any rule customizes the selected goal.

### Step 5: Start, Monitor and Manage the Bot

#### 5.1. Starting the Bot

<div align="left"><figure><img src="https://3071033198-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXCba6CdwFKbzdASxvC5H%2Fuploads%2FL6QergixMSRPY4wP95lu%2Fimage.png?alt=media&amp;token=bc1d3afc-f74a-4afb-b406-6032d3f09983" alt="" width="563"><figcaption></figcaption></figure></div>

After reviewing the configuration, click **Start bot**.

**5.2. Monitoring the Bot**

The bot becomes active and starts searching for pairs that match the selected venues, directions, markets, goal, and rules:

<div align="left"><figure><img src="https://3071033198-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXCba6CdwFKbzdASxvC5H%2Fuploads%2FhFWgzVc8Jd1GEt0o29jn%2Fimage.png?alt=media&amp;token=e1d7ca91-dee7-4db8-a0ea-675ababdfc1e" alt="" width="563"><figcaption></figcaption></figure></div>

The bot page shows the main performance metrics:

* **Total PnL:** total profit or loss accumulated across all bot cycles.
* **Total funding fee:** total funding payments accumulated across all bot cycles.
* **Volume:** total trading volume generated by entries and exits on both legs.
* **Notional hours:** position size multiplied by the time the position was held. For example, a $100 position held for 2 hours contributes $200h.

When the bot is looking for a pair, **Closest to your limits** shows opportunities that were checked but did not meet all selected rules. It includes:

* **Est. funding APR:** the estimated annualized funding return for the pair.
* **P Spread:** the current price spread between the Long and Short legs.
* **Est. round-trip cost:** the estimated cost to open and later close the pair.
* **Why it didn't open:** the rule that prevented the bot from opening that pair.

If no eligible pair is available, the bot continues checking for new opportunities.

**5.3. Managing the Bot**

Click **Stop** to stop the bot from searching for new pairs. The bot becomes inactive:

<div align="left"><figure><img src="https://3071033198-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXCba6CdwFKbzdASxvC5H%2Fuploads%2Fq7HR7oHCCbWaVoj7Q6Er%2Fimage.png?alt=media&amp;token=752c2834-7e76-4251-8609-b8d696865fb2" alt="" width="563"><figcaption></figcaption></figure></div>

While stopped, the bot can be:

* **Started again** with the same settings;
* **Edited** to change its settings before restarting;
* **Deleted** if it is no longer needed.

## Important to Know

* Each leg keeps its own margin on its own venue, so a sharp price move can liquidate one leg even when the overall position is hedged. Higher leverage increases this risk.
* Funding rates, prices, liquidity, and trading costs can change while a bot is running.
* Manual trading can still be used on the same venues while a bot is active. Bots skip markets where a position is already open.
* Up to **20 bots per account** can run at the same time, each with its own venues, directions, markets, sizing, and strategy settings.

## Fees

**There is no additional or special fee for using Arbitrage Bots.**

Bot trades are subject to the same **standard VOOI and venue trading fees** that apply to other trades through VOOI Ultra. No separate bot fee is charged.

[Ultra Trading Fees](/vooi-ultra-v3/vooi_ultra-tradingfees.md)

## Next Steps

* [VOOI Arbitrage Desk](/vooi-ultra-v3/vooi-arbitrage-desk.md): manually review, compare, and open available arbitrage strategies.
