Skip to content

Latest commit

 

History

History
110 lines (75 loc) · 4.28 KB

README.md

File metadata and controls

110 lines (75 loc) · 4.28 KB
Raw

Barbotine arbitrage bot Logo

Twitter @nelsodot GitHub @nelso0

Table of content

Features

  • Compatible with all ccxt exchanges
  • Ready-to-run and easily editable to fit your needs (no need to be an advanced developer)
  • Precise at the orderbook level (close to a market-making algorithm)
  • Can work with an unlimited number of exchanges at the same time
  • Does a balance simulation for every possible opportunity to always choose the most profitable one
  • Opportunities updates on Telegram
  • Full logging system

Demo

demo video: https://youtu.be/Uw6ajbODid0

Prerequisites

  • Python 3+ inferior to 3.12! (for windows users: if python or pip isn't recognized as a command, make sure you have installed python by checking the box "add to PATH")

Installation

  1. Clone the repository
git clone https://github.com/nelso0/barbotine-arbitrage-bot # you can also download the zip file
  1. Go to the repository you just cloned
cd barbotine-arbitrage-bot
  1. Install all the requirements to run the arbitrage system
pip install -r requirements.txt
  1. Set your configuration details in exchange_config.py
  2. Run with:
python run.py

Usage

You can also run it with one line like this:

python run.py <mode> [renew-time-minutes] <balance-usdt-to-use> <pair> <exchanges list separated by commas (no space!)>

  • <mode> = the mode you wanna use between fake-money and real. See #full-version for real mode.

    • fake-money will run the bot with the balance-usdt-to-use you put, with a virtual balance, just to test.
    • real will run the bot with real money.

  • [renew-time-minutes] = ONLY IF YOU ENABLED RENEWAL SETTING IN THE CONFIG. If you enabled it, you have to put the number of minutes a session should last. After each session, the bot sells all the assets back to rebalance. Note: you can trigger a manual rebalance while in a session by pressing the Enter key.

  • <balance-usdt-to-use> = how to be clearer?

  • <pair> = The pair you wanna arbitrage on.

  • <exchanges list> = the exchanges you want the bot to scan the orderbooks on, among all the CCXT-compatible exchanges. From a 2 exchanges minimum, up to an unlimited number. Don't forget to configure the exchanges in exchange_config.py.

Note: as the bot needs to buy assets before getting started (it's necessary in order to operate without transfer between exchanges, read more here), if the pair you have chosen looses in value, you'll end up losing money when rebalancing. To avoid that, I created a delta-neutral feature that places a short order to "hedge" and counterbalance the purchase of coins by the bot. You can enable this feature in exchange_config.py.

Examples:

python run.py fake-money 15 500 EOS/USDT binance,okx,kucoin    # run the bot with 500 USDT and rebalance every 15 minutes, with binance okx and kucoin
python run.py real 15 1000 SOL/USDT binance,poloniex,kucoin   # run the bot with 1000 USDT on binance phemex and bybit on SOL/USDT, and rebalance every 15 minutes.

Real money modes

The source code of the arbitrage bot that works with real money is available on the Barbotine's shop.

Link: barbotine.xyz/shop

Contact and documentation

nelso@barbotine.xyz

Full documentation