CryptoTeller Bot

CryptoTeller is a Telegram bot designed to provide real-time cryptocurrency prices and currency conversion rates. It supports multiple cryptocurrencies and fiat currencies, and it can be used in both private chats and groups. The bot uses CoinMarketCap and ExchangeRate-API to fetch the latest data.

Features

• Real-time Cryptocurrency Prices: Get the latest prices for popular cryptocurrencies like Bitcoin (BTC), Ethereum (ETH), and more.
• Currency Conversion: Convert between various fiat currencies and cryptocurrencies.
• Pagination: Navigate through multiple pages of cryptocurrency data.
• Whitelisting: Restrict bot usage to specific groups by whitelisting their chat IDs.
• API Key Rotation: Automatically rotate through multiple API keys to avoid rate limits.

Commands

• /start: Starts a conversation with the bot.
• /crypto: Displays the current prices of supported cryptocurrencies.
• /wlstatus: Checks if the current group is whitelisted.
• /help: Displays a list of available commands and their descriptions.
• /api: (Developer Only) Shows the currently used API key.

Setup

Prerequisites

• Python 3.7 or higher
• A Telegram bot token (obtainable from BotFather)
• CoinMarketCap API key(s) (available from CoinMarketCap)
• ExchangeRate-API key(s) (available from ExchangeRate-API)

Installation

1. Clone the repository:

   git clone https://github.com/RGB-Outl4w/CryptoTeller.git
   cd CryptoTeller

2. Install the required dependencies:

   pip install -r requirements.txt

3. Create a .env file in the root directory and add your Telegram bot token:

   MAIN_KEY=your_telegram_bot_token
   

4. Update the constants.py file with your CoinMarketCap and ExchangeRate-API keys, as well as your whitelisted chat IDs.

Running the Bot

To start the bot, run:

python cryptoTeller.py

Configuration

• CoinMarketCap API Keys: Add your API keys to the CMC_API_KEYS list in constants.py.
• ExchangeRate-API Keys: Add your API keys to the EXCHANGE_RATE_API_KEYS list in constants.py.
• Whitelisted Chat IDs: Add the chat IDs of the groups where you want the bot to be active in the WHITELISTED_CHAT_IDS tuple in constants.py.

Contributing

Contributions are welcome! Please feel free to submit a pull request or open an issue if you have any suggestions or find any bugs.

License

This project is licensed under the MIT License. See the LICENSE file for more details.

Acknowledgments

• CoinMarketCap for providing the cryptocurrency data.
• ExchangeRate-API for providing the currency conversion rates.
• pyTelegramBotAPI for the Telegram bot library.

Support

If you find this project useful, consider supporting it by donating or becoming a sponsor. Your support helps keep the project alive and continuously improved.