# 🤖 Crypto Telegram Alert Bot
**🚀 Real-time cryptocurrency price alerts delivered straight to your Telegram**
*Never miss a buy or sell opportunity again!*
[](#deployment)
## ✨ Features
|
### 🎯 **Smart Alerts** - **Buy/Sell Notifications** - Get alerted when prices hit your targets - **Real-time Monitoring** - Checks prices every 30 seconds - **Multiple Coins** - Support for 10 major cryptocurrencies - **Custom Thresholds** - Set your own price targets |
### 🔧 **Easy to Use** - **Simple Commands** - - **Instant Setup** - Just start chatting with the bot - **24/7 Operation** - Never stops monitoring - **Multi-user Support** - Share with friends and family |
## 🚀 Quick Start
### 1. **Start Using the Bot**
**Click the green button above or search for @My\_Crypto\_Coin\_Alert\_bot in Telegram**
#### 📱 **How to Access the Bot:**
**Method 1: Direct Link (Recommended)**
- Click the green button above
- If using Telegram Web and it doesn't work, try Telegram Desktop app
**Method 2: Manual Search**
1. Open Telegram (Desktop app recommended)
2. Click the search bar 🔍
3. Type: @My\_Crypto\_Coin\_Alert\_bot
4. Click on the bot
5. Type: /start
**Method 3: Direct URL**
Copy and paste this link: https://t.me/My\_Crypto\_Coin\_Alert\_bot
#### 🔧 **Troubleshooting Bot Access:**
**Bot not responding when you click "Start"?**
- ✅ **Use Telegram Desktop app** instead of web version
- ✅ **Type /start manually** instead of clicking the button
- ✅ **Check you're logged into the correct Telegram account**
- ✅ **Try in incognito/private browser mode**
- ✅ **Clear browser cache** and refresh
**Still having issues?**
- Search manually for @My\_Crypto\_Coin\_Alert\_bot in Telegram
- Make sure you're using the same account as your phone
- Try accessing from your mobile phone first
### 2. **Basic Commands**
/start - Initialize the bot
/prices - View current crypto prices
/buy - Set buy alert (e.g., /buy bitcoin 30000)
/sell - Set sell alert (e.g., /sell eth 2500)
/alerts - View your active alerts
/help - Show all commands
### 3. **Example Usage**
👤 You: /prices
🤖 Bot: 📊 Current Crypto Prices:
₿ BTC: $43,250.00
Ξ ETH: $2,580.00
...
👤 You: /buy bitcoin 40000
🤖 Bot: ✅ Buy alert set!
₿ BTC at $40,000.00
I'll notify you when the price drops to this level.
\[Later when price hits target]
🤖 Bot: 🔔 BUY ALERT!
₿ BTC has reached your buy target!
Current: $39,950.00
Target: $40,000.00
💡 Good opportunity to buy!
## 💰 Supported Cryptocurrencies
| Coin | Symbol | Emoji |
|------|--------|-------|
| **Bitcoin** | BTC | ₿ |
| **Ethereum** | ETH | Ξ |
| **Solana** | SOL | ☀️ |
| **XRP** | XRP | 💧 |
| **Cardano** | ADA | ₳ |
| **Dogecoin** | DOGE | 🐕 |
| **Polkadot** | DOT | ⚫ |
| **Chainlink** | LINK | 🔗 |
| **Polygon** | MATIC | 🔷 |
| **Litecoin** | LTC | Ł |
## 🛠️ Technical Stack
| Component | Technology | Purpose |
|-----------|------------|---------|
| **Bot Framework** | python-telegram-bot | Telegram integration |
| **Price Data** | CoinGecko API | Real-time crypto prices |
| **Database** | SQLite | User data and alerts |
| **Deployment** | Heroku | 24/7 cloud hosting |
| **Monitoring** | Background threads | Continuous price checking |
## 📊 Architecture
┌─────────────────┐ ┌──────────────────┐ ┌─────────────────┐
│ Telegram │ │ Heroku Bot │ │ CoinGecko │
│ Users │◄──►│ Application │◄──►│ API │
│ │ │ │ │ │
│ Send commands │ │ • Process msgs │ │ • Price data │
│ Receive alerts │ │ • Monitor prices │ │ • Market info │
└─────────────────┘ │ • Send alerts │ └─────────────────┘
│ • Store data │
└──────────────────┘
│
┌──────────────────┐
│ SQLite DB │
│ │
│ • User data │
│ • Alert settings │
│ • Preferences │
└──────────────────┘
## 🚀 Deployment
### Deploy Your Own Bot
[](https://heroku.com/deploy)
#### Prerequisites
- Python 3.8+
- Telegram Bot Token (from [@BotFather](https://t.me/botfather))
- Heroku account
#### Local Setup
\# Clone the repository
git clone https://github.com/LDolanLDolan/crypto-telegram-bot.git
cd crypto-telegram-bot
\# Create virtual environment
python -m venv venv
source venv/bin/activate # On Windows: venv\\Scripts\\activate
\# Install dependencies
pip install -r requirements.txt
\# Set environment variable
export TELEGRAM\_BOT\_TOKEN="your\_bot\_token\_here"
\# Run the bot
python crypto\_bot.py
#### Heroku Deployment
\# Login to Heroku
heroku login
\# Create app
heroku create your-crypto-bot-name
\# Set bot token
heroku config:set TELEGRAM\_BOT\_TOKEN="your\_bot\_token\_here"
\# Deploy
git push heroku main
\# Scale worker
heroku ps:scale worker=1
## 📈 Performance & Reliability
- **🔄 Uptime**: 99.9% availability on Heroku
- **⚡ Response Time**: < 1 second for commands
- **🔍 Monitoring**: Checks prices every 30 seconds
- **📱 Delivery**: Instant Telegram notifications
- **💾 Data**: Persistent SQLite database
- **🔒 Security**: Environment-based token storage
## 💡 Advanced Features
### Custom Alerts
- Set multiple alerts per cryptocurrency
- Percentage-based notifications
- Portfolio tracking capabilities
### Future Enhancements
- [ ] Portfolio value tracking
- [ ] Price charts and graphs
- [ ] News integration
- [ ] DeFi protocol monitoring
- [ ] Technical analysis alerts
## 🤝 Contributing
Contributions are welcome! Here's how you can help:
1. **🍴 Fork** the repository
2. **🌿 Create** a feature branch (git checkout -b feature/amazing-feature)
3. **💾 Commit** your changes (git commit -m 'Add amazing feature')
4. **📤 Push** to the branch (git push origin feature/amazing-feature)
5. **🔄 Open** a Pull Request
### Ideas for Contributions
- Add support for more cryptocurrencies
- Implement portfolio tracking
- Add technical analysis indicators
- Create web dashboard interface
## 📄 License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## 🆘 Support & Troubleshooting
### 🔧 **Bot Access Issues**
**❓ Bot not responding when you click "Start Bot"?**
| Issue | Solution |
|-------|----------|
| 🌐 **Using Telegram Web** | Switch to **Telegram Desktop app** - works more reliably |
| 🔄 **Start button not working** | Type /start **manually** in the chat |
| 👤 **Wrong account** | Make sure you're logged into the **same Telegram account** as your phone |
| 🔍 **Can't find bot** | Search manually: @My\_Crypto\_Coin\_Alert\_bot |
| 💻 **Browser issues** | Try **incognito mode** or clear browser cache |
**✅ Recommended Access Method:**
1. **Download Telegram Desktop**: https://desktop.telegram.org/
2. **Search**: @My\_Crypto\_Coin\_Alert\_bot
3. **Type manually**: /start
### 📱 **Alternative Access Methods**
**Direct URL**: Copy and paste this link
https://t.me/My\_Crypto\_Coin\_Alert\_bot
**QR Code**: Create one at qr-code-generator.com with the bot link above
### 🛠️ **Technical Support**
**Bot not responding to commands?**
- Check if the bot is online: Try /help command
- Verify spelling: Commands are case-sensitive
- Wait a few seconds: Sometimes there's a slight delay
**Price alerts not working?**
- Ensure your target prices are realistic
- Check that you've set alerts correctly: /alerts
- Verify the bot has permission to send you messages
**Other issues?**
- 📧 **Issues**: [Create an issue](https://github.com/LDolanLDolan/crypto-telegram-bot/issues)
- 💬 **Discussions**: [Join the discussion](https://github.com/LDolanLDolan/crypto-telegram-bot/discussions)
- 📖 **Documentation**: Check the code comments and this README
### ⚡ **Quick Fixes**
**Bot suddenly stopped working?**
- Bot may be restarting (Heroku apps restart daily)
- Wait 1-2 minutes and try again
- Check [Heroku Status](https://status.heroku.com/) for outages
**Commands not recognized?**
- Make sure to include the / before commands
- Example: /prices not prices
- Try /help to see all available commands
## 🌟 Acknowledgments
- **CoinGecko** for providing free cryptocurrency data
- **python-telegram-bot** for the excellent Telegram library
- **Heroku** for reliable cloud hosting
- **The crypto community** for inspiration and feedback
## 🚀 **Ready to Get Started?**
[](https://t.me/My\_Crypto\_Coin\_Alert\_bot)
**⭐ Star this repository if you found it helpful!**
### 📞 **Need Help?**
**Can't access the bot?** Try these solutions:
- Use **Telegram Desktop app** instead of web browser
- Search manually: @My\_Crypto\_Coin\_Alert\_bot
- Type /start manually instead of clicking buttons
- Make sure you're on the same Telegram account as your phone
**Technical issues?**
- 📧 [Create an Issue](https://github.com/LDolanLDolan/crypto-telegram-bot/issues)
- 💬 [Join Discussion](https://github.com/LDolanLDolan/crypto-telegram-bot/discussions)
*Built with ❤️ for the crypto community*