For the complete documentation index, see llms.txt. This page is also available as Markdown.

Funding Arbitrage Bot Example

VOOI open-source example of a delta-neutral funding-rate arbitrage bot for perpetual markets

Overview

Funding Arbitrage Bot is an open-source trading bot designed for delta-neutral funding-rate arbitrage across supported perpetual venues.

The bot uses VOOI funding strategy data to find potential funding-rate arbitrage setups between supported venues. When a strategy meets the configured conditions, the bot can open paired positions on the same asset: one long position and one short position.

The goal is to reduce directional price exposure while collecting the funding-rate difference between venues.

You can also inspect, test, and customize this bot with AI coding agents such as Claude Code, Codex, or Cursor.

How it works

The bot is based on the same type of funding arbitrage workflow available in VOOI Ultra: VOOI Funding Arbitrage

It uses VOOI funding strategy data to find potential cross-venue setups for the same asset. When a strategy meets the configured conditions, the bot can open two opposite positions for the same asset:

  • long position on one venue

  • short position on another venue

The two legs are designed to offset each other’s price exposure.

After opening a position, the bot monitors the strategy and can close it when the spread decays, reverses, reaches the maximum holding time, or hits configured risk limits.

What this example demonstrates

This bot is useful as a technical example for:

  • cross-venue funding-rate strategies

  • paired long and short position management

  • automated monitoring and order placement

  • risk controls for automated strategies

  • agent-assisted customization of trading automation

Before running this bot

Trading bots can place real orders and interact with real funds.

Before running any example with live capital:

  1. Read the repository README.

  2. Review the strategy, configuration, and risk controls.

  3. Inspect the code yourself or ask an AI coding agent to inspect it.

  4. Start with dry-run or test mode where available.

  5. Use small balances first.

  6. Monitor logs, open positions, and bot activity.

Important risks include funding spread reversal, one leg filling while the other fails, venue outages, slippage, liquidation risk, incorrect configuration, and loss of access to credentials or the runtime environment.

Requirements

The exact setup requirements are maintained in the repository README.

In general, this bot is intended for users who have:

  • VOOI Ultra account with access to API token generation

  • VOOI API token generated in VOOI Ultra https://ultra.vooi.io/api-tokens

  • balances on at least two supported perpetual venues

  • bot-specific venue settings required for the selected exchanges

  • a local machine or server where the bot can run

  • enough technical experience to review logs and configuration files

VOOI Perps API is not publicly available as a standalone public API. These examples use API access available through VOOI Ultra for registered users.

Check the repository README for the current list of required credentials, environment variables, supported venues, and deployment options.

Deployment and Repository

The repository README includes the current setup and deployment instructions.

Typical setup flows may include local dry-run testing, VPS deployment for long-running operation, or container-based deployment if supported by the repository.

Repository: https://github.com/vooi-app/vooi-funding-bot-example

Using an AI coding agent (optional)

You can ask Claude Code, Codex, Cursor, or another coding agent to inspect the codebase, explain the funding arbitrage logic, review risk parameters, and help run the bot in dry-run mode before any live deployment.

This workflow can be useful for agentic trading and what is often called vibe coding: start from an existing open-source bot, describe what you want to change, and use an AI coding agent to help modify and test the implementation.

Example prompt:

Inspect this repository and explain what the Funding Arbitrage Bot does.

Read the README, configuration files, dependency files, and deployment instructions.

Check whether there are unsafe operations, hard-coded secrets, suspicious dependencies, or anything that should be reviewed before running the bot with real funds.

Explain what credentials and settings are required from me.

Help me set up the bot in dry-run or test mode first.

Do not enable live trading or place real orders unless I explicitly confirm.

Next Steps

Last updated