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) -
π¨ Panic button (Kills Binance Trade Bot Manager Telegram and cancels all open orders / sells at market price) - User defined custom scripts
The program's default behavior fetches Telegram token
and chat_id
from Binance Trade Bot's apprise.yml
file.
Only the Telegram users in the chat with chat_id
equal to the one set in the apprise.yml
file will be able to use the bot.
RWX
permission problems are present on 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
- Clone this repository:
$ git clone https://github.com/lorcalhost/BTB-manager-telegram.git
- Move to
BTB-manager-telegram
's directory:
$ cd BTB-manager-telegram
- 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.
Note:
BTB-manager-telegram
also supports user defined custom scripts.
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 &
# If you are using a virtual environment for the binance trade bot you can specify the Python binary path
$ python3 -m btb_manager_telegram --python_path=/home/pi/binance-trade-bot/venv/bin/python
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 chat_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 path
-y PYTHON, --python_path PYTHON_PATH
(optional) Python binary to be used for the BTB. If unset, uses the same executable (and thus virtual env if any) than the telegram bot.
-t TOKEN, --token TOKEN
(optional) Telegram bot token
-c CHAT_ID, --chat_id CHAT_ID
(optional) Telegram chat id
-d DOCKER, --docker DOCKER
(optional) Run the script in a docker container.
NOTE: Run the 'docker_setup.py' file before passing this flag.
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.
You can also add the bot to a group if multiple people need to access this bot. Please note that each user will have to type /start
in the group, before they can start interacting with the bot.
Screenshots
Troubleshooting
Support the project
I am currently a broke university student, if you like my work and use it on a daily basis consider supporting the project through a small donation.
Donations through GitHub sponsors will be matched by GitHub (e.g. if you decide to donate 10$, GitHub will add 10$ to the donation).
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.
β¨
Contributors Many people contributed to the project by providing ideas, finding bugs and helping in the development (Emoji Key
This project follows the all-contributors specification.
How to build image
docker buildx build -t hustlers4u/btb-manager-telegram . --platform linux/arm/v7