⚡ TheTickrBot v2.0

A full-featured Telegram crypto bot — real-time prices, portfolio tracking, price alerts, market sentiment, and inline mode. Built with Python and the CoinGecko API.

Features

💰 Price Tracking

• Real-time prices in USD ($), GBP (£), EUR (€)
• 24h change, volume, and market cap
• Top 10 coins by market cap
• Smart search — works with names, symbols, or IDs

📈 7-Day Sparkline Charts

• Visual price trend using Unicode sparklines
• Open/Close/High/Low stats

🔔 Price Alerts

• Set alerts: above or below target price
• Auto-checks every 60 seconds
• Instant notification when triggered
• Up to 10 alerts per user

💼 Portfolio Tracker

• Track holdings with buy price
• Real-time P/L calculation (per holding + total)
• One-tap refresh

📊 Fear & Greed Index

• Live market sentiment from Alternative.me
• Visual progress bar

🔘 Button Navigation

• Full inline keyboard navigation
• One-tap access to all features from main menu
• Context-aware buttons on every screen

⚡ Inline Mode

• Type @YourBotName bitcoin in any chat
• Share prices without opening the bot

Commands

Command	Description
/start	Main menu with button navigation
/price <coin>	Price in USD, GBP, EUR
/top	Top 10 by market cap with sparklines
/convert <amt> <coin>	Convert to fiat currencies
/chart <coin>	7-day sparkline chart
/alert <coin> above/below <price>	Set price alert
/myalerts	View active alerts
/removealert <n>	Remove an alert
/add <amt> <coin> at <price>	Add portfolio holding
/portfolio	View portfolio & P/L
/removeholding <n>	Remove a holding
/fng	Fear & Greed Index
/help	All commands

Quick Start

git clone https://github.com/YOUR_USERNAME/thetickrbot.git
cd thetickrbot
pip install -r requirements.txt
export BOT_TOKEN="your-token-from-botfather"
python bot.py

Tech Stack

Component	Technology
Language	Python 3.9+
Telegram API	python-telegram-bot v21
Price Data	CoinGecko API (free)
Sentiment	Alternative.me Fear & Greed API
Storage	JSON file-based (no database needed)

Project Structure

thetickrbot/
├── bot.py              # Main bot (all features)
├── requirements.txt    # Dependencies
├── data/               # Auto-created for alerts & portfolios
│   ├── alerts.json
│   └── portfolios.json
├── .env.example
├── .gitignore
├── LICENSE
└── README.md

Deployment

Deploy for free on Railway, Render, or any VPS with Python. Set BOT_TOKEN as an environment variable.

License

MIT — free to use, modify, and distribute.