sleeyax / voltra

Cross-market volatile cryptocurrency trading bot
GNU General Public License v3.0
29 stars 2 forks source link
algorithmic-trading binance binance-bot bitcoin btc cryptocurrencies cryptocurrency cryptocurrency-trading-bot go-crypto-volatility-trading-bot trade trading-bot

logo

Voltra

A cross-market cryptocurrency volatility trading bot written in go.

[!WARNING]
Trading cryptocurrency carries risks. This bot is a tool, not financial advice. Use at your own discretion.

[!NOTE]
This project has entered its alpha phase. We welcome you to report and/or help resolve any bugs!

build status

Strategy

The bot analyses changes in price of all coins across all supported marketplaces and places trades on the most volatile ones.

Features

Supported markets

If you're a developer, you can add support for a new marketplace by implementing the Market interface here. See the Binance implementation as an example. Comment on the relevant issue if you need help.

Getting started

First of all, make sure you have a valid config file. You can use the example config as a starting point:

$ cp config.example.yml config.yml

Open the file in your text editor of choice and edit it according to your preferred trading strategy. Don't forget to at least configure your API keys!

Binaries

The easiest way to get started is by downloading the latest release for your operating system from the releases page. Extract the archive, copy your config file to the same directory and finally run the binary in a terminal/command prompt as follows:

$ ./voltra

Docker

You can run the bot on any platform or cloud provider that supports Docker.

First, pull the latest image from GitHub's container registry as follows:

$ docker pull ghcr.io/sleeyax/voltra:latest
OR click here for instructions to build from source Clone the source code and build the docker image locally: ```sh $ git clone https://github.com/sleeyax/voltra.git $ cd voltra $ docker build --tag ghcr.io/sleeyax/voltra:latest . ```

Then, to run the bot you have the option to run with our without data persistence. When you opt for the latter, any outputted data such as your database will be deleted as soon as the container is removed.

$ docker run --name voltra --volume ./config.yml:/bot/config.yml:ro --volume ./data:/bot/data -it sleeyax/voltra:latest

Alternatively, you can store your config file in the data directory and only mount that directory:

$ docker run --name voltra --volume ./data:/bot/data -it sleeyax/voltra:latest
$ docker run --name voltra --volume ./config.yml:/bot/config.yml:ro -it sleeyax/voltra:latest

Credits

Inspired by CyberPunkMetalHead/Binance-volatility-trading-bot and its many forks.