The Crypto Tracker Telegram Bot allows users to monitor cryptocurrency prices, maintain a personalized watchlist, and set notifications for price changes. The bot is built using the Telebot library and interacts with users through intuitive commands and messages.
- Add Tokens to Watchlist: Track your favorite cryptocurrencies by adding them to your watchlist.
- Set Price Notifications: Get notified when a cryptocurrency's price changes by a specified percentage.
- View Watchlist: Check the current prices of the tokens in your watchlist.
- View Notifications: Review your active price notifications.
- Remove Tokens and Notifications: Manage your watchlist and notifications with ease.
Command | Description |
---|---|
/start or /help | Displays a welcome message and a list of available commands. |
/addtoken | Starts the process of adding a new token to your watchlist by selecting the network and entering the token's contract address. |
/addnotification | Allows you to set a notification for a token based on price changes. |
/viewwatchlist | Shows your current watchlist with live prices. |
/viewnotifications | Lists all your active notifications. |
/removewatchlist | Removes a specified token from your watchlist. |
/removenotification | Removes a specific notification. |
- Python 3.x
- Telegram Bot API token (obtainable via the BotFather on Telegram)
-
Clone the Repository:
git clone https://github.com/SP1R4/PriceTrackerBot.git cd PriceTrackerBot
-
Install Dependencies:
pip3 install -r requirements.txt
-
Create Configuration Files:
WATCHLIST_FILE
: A JSON file to store the user's watchlist.NOTIFICATIONS_FILE
: A JSON file to store the user's notifications.
-
Run the Bot:
python3 PriceTracker.py
- Start the Bot: Send
/start
or/help
to get a list of available commands. - Add a Token: Use
/addtoken
and follow the prompts to add a token to your watchlist. - Set Notifications: Use
/addnotification
and specify the conditions for notifications. - View and Manage Watchlist: Use
/viewwatchlist
to see the current prices and/removewatchlist
to remove tokens. - Manage Notifications: Use
/viewnotifications
to see active notifications and/removenotification
to remove them.
The bot logs important events and errors to crypto_tracker.log
. This file can be used to track bot activity and diagnose issues.
Feel free to fork this repository and submit pull requests. For major changes, please open an issue first to discuss what you would like to change.
For any questions or support, please open an issue or contact [email protected].