ManualTrader/QUICK_START.md

🚀 Quick Start - Your Questions Answered

✅ Stats Persistence: YES, Forever Saved!

Your trading statistics are permanently saved to trading_stats.json and automatically loaded every time you restart the bot. Your complete trading history, P&L, win rates, and all performance metrics survive forever between launches.

📁 Organized Structure: Clean & Simple

trader_hyperliquid/
├── 🚀 trading_bot.py              # ONE COMMAND TO RUN EVERYTHING
├── 📊 trading_stats.json          # Your persistent data
├── 📝 .env                        # Your config
├── 
├── 🔧 src/                        # Core modules (don't touch)
├── 🛠️ utils/                      # Setup helpers
├── ⚙️ config/                     # Configuration template
└── 📋 logs/                       # Auto-created logs & errors

🎯 Single Command Launch: Super Simple

python trading_bot.py    # THIS IS ALL YOU NEED!

• ✅ Launches Telegram bot automatically
• ✅ Handles all errors and restarts
• ✅ Sends notifications to your phone
• ✅ Manages all logging and persistence

🛡️ Built-in Safeguards: Bulletproof

• 🔄 Auto-restart: Up to 10 attempts if crashes
• 📱 Error notifications: Instant alerts to your Telegram
• 📝 Complete logging: All errors saved to files
• ⚙️ Graceful shutdown: Ctrl+C stops cleanly
• 📊 Data protection: Stats never lost

🚀 Setup in 3 Minutes

1. Get Telegram Chat ID

python utils/get_telegram_chat_id.py

2. Configure Bot

cp config/env.example .env
nano .env  # Add your keys and Chat ID

3. Start Trading!

python trading_bot.py

📱 What Happens When You Start

1. 🔍 Validates all your configuration
2. 📊 Loads your existing trading statistics (if any)
3. 🚀 Starts Telegram bot for phone control
4. 📱 Sends startup notification to your phone
5. 🛡️ Monitors for errors and auto-restarts if needed
6. 📝 Logs everything to daily log files

🆘 Error Handling Examples

If Bot Crashes:

• 🔄 Auto-restarts in 5 seconds
• 📱 Sends error alert to your Telegram
• 📝 Logs details to logs/bot_errors.log
• ⏰ Increases delay for repeated failures

If Internet Disconnects:

• 🔄 Keeps trying to reconnect
• 📱 Notifies you when back online
• 📊 Preserves all your trading data

If Configuration Missing:

• ❌ Stops safely before starting
• 💡 Shows clear instructions for setup
• 📝 Tells you exactly what's missing

📊 Your Trading Data is Safe

Persistent Between Launches:

• ✅ Starting balance remembered
• ✅ All trade history preserved
• ✅ Performance metrics calculated
• ✅ Risk analytics maintained
• ✅ Win/loss streaks tracked

Automatic Backups:

• 📝 Every trade logged to files
• 📊 Statistics saved after each trade
• 🔄 Daily log files created
• 📱 Critical events sent to phone

🎯 Daily Usage

Start Bot:

python trading_bot.py

Trade via Phone:

• Open Telegram → Find your bot
• Send /start for quick buttons
• Use /buy 0.001 50000 to trade
• Check /stats for performance

Monitor:

• Bot sends error notifications automatically
• Check /stats for trading performance
• View logs: tail -f logs/trading_bot_$(date +%Y%m%d).log

🔧 Troubleshooting

"Configuration validation failed"

cp config/env.example .env
nano .env  # Add your keys

"Import error"

source venv/bin/activate
pip install -r requirements.txt

"Telegram not responding"

python utils/get_telegram_chat_id.py  # Get correct Chat ID

💡 Key Benefits

1. 🚀 One Command: python trading_bot.py does everything
2. 📊 Never Lose Data: Statistics persist forever
3. 🛡️ Self-Healing: Auto-restarts on errors
4. 📱 Phone Alerts: Know about issues instantly
5. 📝 Complete Audit: Full logging of everything
6. ⚙️ Foolproof Setup: Clear validation and instructions

Your trading bot is now professional-grade with phone control and bulletproof reliability! 🚀📱