pwnfoo / BTB-manager-telegram

A Telegram bot for remotely managing Binance Trade Bot

Binance Trade Bot Manager Telegram

A Telegram bot for remotely managing Binance Trade Bot.

About

I wanted to develop an easy way of managing Binance Trade Bot so that I wouldn't have to constantly ssh into my VPS, and my non-techy friends could enjoy the benefits of automated trading.

As of now the bot is able to perform the following actions:

• 🔍 Check bot status (running / not running)
• ▶ Start Binance Trade Bot
• ⏹ Stop Binance Trade Bot
• 💵 Display current coin stats (balance, USD value, BTC value, initial buying price)
• ➗ Display current coin ratios
• 📈 Display progress (how much more of a certain coin you gained since you started using Binance Trade Bot)
• ⌛ Display trade history
• 📜 Display last 4000 characters of log file
• 👛 Edit coin list (supported_coin_list file)
• ⚙ Edit user configuration (user.cfg file)
• ❌ Delete database file (crypto_trading.db file)
• 📤 Export database file
• ⬆ Update Binance Trade Bot (and notify when new update is available)
• ⬆ Update Binance Trade Bot Manager Telegram (and notify when new update is available)

The program's default behavior fetches Telegram token and user_id from Binance Trade Bot's apprise.yml file.
Only the Telegram user with user_id equal to the one set in the apprise.yml file will be able to use the bot.

⚠ The program is fully compatible with Linux and Windows through WSL, further compatibility testing needs to be done for native Windows and MacOS.

Installation

Python 3 is required.
BTB-manager-telegram should be installed in the same parent directory as Binance Trade Bot.
Your filesystem should look like this:

.
└── *parent_dir*
    ├── BTB-manager-telegram
    └── binance-trade-bot

1. Clone this repository:

$ git clone https://github.com/lorcalhost/BTB-manager-telegram.git

2. Move to BTB-manager-telegram's directory:

$ cd BTB-manager-telegram

3. Install BTB-manager-telegram's dependencies:

$ python3 -m pip install -r requirements.txt

⚠ Make sure the correct rwx permissions are set and the program is run with correct privileges.

Setup

• For a quick Telegram bot setup guide click here.
• For a Docker setup guide click here.
• If you would like to run several Binance Trade Bot instances at the same time click here.

Usage

BTBManagerTelegram can be run directly by executing the following command:

# Run normally
$ python3 -m btb_manager_telegram

# If the bot is running on a server you may want to keep it running even after ssh connection is closed by using nohup
$ nohup python3 -m btb_manager_telegram &

Make sure Binance Trade Bot's apprise.yml file is correctly setup before running.

Note:
If Binance Trade Bot and BTB-Manager-Telegram were not installed in the same parent directory or you want to use different token and user_id from the ones in the apprise.yml file, the following optional arguments can be used:

optional arguments:
  -p PATH, --path PATH  (optional) binance-trade-bot installation absolute path
  -t TOKEN, --token TOKEN
                        (optional) Telegram bot token
  -u USER_ID, --user_id USER_ID
                        (optional) Telegram user id
  -d DOCKER, --docker DOCKER
                        (optional) Run the script in a docker container.
                        NOTE: Run the 'docker_setup.py' file before passing this flag.

⚠ Please check the Docker setup guide if you would like to run the bot in a Docker container.

Interaction

Interaction with BTBManagerTelegram can be started by sending the /start command in the bot's Telegram chat.
Every time the Telegram bot is restarted the /start command should be sent again.

Screenshots

Click here

         

Troubleshooting

Support the project

Contributions and feature requests

If you have any feature requests please open an issue.

Contributions from anyone are welcome! Before opening pull requests please read the contributing guidelines.

Disclaimer

This project is for informational purposes only. You should not consider any such information or other material as legal, tax, investment, financial, or other advice. Nothing contained here constitutes a solicitation, recommendation, endorsement, or offer by me or any third party service provider to buy or sell any securities or other financial instruments in this or in any other jurisdiction in which such solicitation or offer would be unlawful under the securities laws of such jurisdiction.

If you plan to use real money, USE AT YOUR OWN RISK.

Under no circumstances will I or the project's maintainers be held responsible or liable in any way for any claims, damages, losses, expenses, costs, or liabilities whatsoever, including, without limitation, any direct or indirect damages for loss of profits.

⚙ Developed for love of task automation by Lorenzo Callegari