📱 Manual Hyperliquid Trading Bot

Control your Hyperliquid account from your phone with comprehensive trading statistics

This bot provides complete manual control of your Hyperliquid account via Telegram, with professional-grade statistics tracking including P&L, win rates, Sharpe ratio, Sortino ratio, and all the metrics you'd expect from a trading platform.

🎯 What This Bot Does

📱 Phone Control: Trade from anywhere using Telegram commands
📊 Comprehensive Stats: Track all your performance metrics from day one
💰 Balance Tracking: Monitor starting vs current balance with real-time P&L
🏆 Performance Metrics: Win rate, profit factor, expectancy, consecutive wins/losses
📈 Risk Analysis: Sharpe ratio, Sortino ratio, max drawdown, VaR (95%)
🔄 Trade History: Complete trade logging with automatic P&L calculation
🛡️ Safety First: Order confirmations, testnet mode, comprehensive logging

🚀 Quick Start

1. Install Dependencies

# Clone or download this repository
cd trader_hyperliquid

# Create virtual environment
python3 -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

2. Set Up Telegram Bot

Create a bot: Message @BotFather on Telegram
- Send /newbot
- Choose a name and username for your bot
- Save the bot token
Get your Chat ID: Run the helper script
```
python get_telegram_chat_id.py
```
- Start the script and message your bot
- Copy the displayed Chat ID

3. Configure Environment

# Copy example configuration
cp env.example .env

# Edit .env with your details
nano .env  # or use any text editor

Required settings in .env:

# Hyperliquid API
HYPERLIQUID_PRIVATE_KEY=your_private_key_here
HYPERLIQUID_TESTNET=true

# Telegram Bot
TELEGRAM_ENABLED=true
TELEGRAM_BOT_TOKEN=your_bot_token_here
TELEGRAM_CHAT_ID=your_chat_id_here

# Trading Settings
DEFAULT_TRADING_SYMBOL=BTC/USDC:USDC
DEFAULT_TRADE_AMOUNT=0.001

4. Start Manual Trading

python manual_trading_bot.py

📱 Using Your Trading Bot

Quick Actions (Buttons)

Open Telegram → Find your bot → Send /start

You'll see quick action buttons for:

💰 Balance - Check account balance with P&L
📊 Stats - Complete trading statistics
📈 Positions - Open positions with unrealized P&L
📋 Orders - Pending orders
💵 Price - Current market price
🔄 Recent Trades - Your trade history

Manual Trading Commands

Place Orders:

/buy 0.001 50000    # Buy 0.001 BTC at $50,000
/sell 0.001 55000   # Sell 0.001 BTC at $55,000

Monitor Account:

/balance     # Account balance + P&L summary
/positions   # Open positions
/orders      # Pending orders
/trades      # Recent trade history

View Statistics:

/stats       # Complete trading statistics

📊 Trading Statistics Tracked

Balance & P&L

💰 Starting Balance: Recorded when bot first launches
💵 Current Balance: Real-time balance updates
📈 Total P&L: Profit/Loss in USD and percentage
📅 Days Active: Time since first launch

Performance Metrics

🏆 Win Rate: Percentage of profitable trades
💎 Profit Factor: Total gains ÷ Total losses
�� Average Win/Loss: Mean profit/loss per trade
🎯 Expectancy: Expected value per trade
🔥 Consecutive Wins/Losses: Streak tracking

Risk Metrics

📊 Sharpe Ratio: Risk-adjusted returns
📉 Sortino Ratio: Downside risk-adjusted returns
📈 Max Drawdown: Largest peak-to-trough decline
🌪️ Volatility: Annualized price volatility
⚠️ VaR (95%): Value at Risk (95% confidence)

Trade Analytics

📝 Total Trades: Complete trade count
🔄 Buy/Sell Breakdown: Order type distribution
🎯 Best/Worst Trades: Largest wins and losses
📊 Trade History: Complete audit trail with order IDs

🛡️ Safety Features

Testnet First

Starts in testnet mode by default
Test all features before using real money
Clear warnings when switching to mainnet

Order Confirmations

All trades require explicit confirmation
Clear order details before execution
Easy cancellation option

Comprehensive Logging

All actions logged with timestamps
Trade history automatically saved
Statistics persist between bot restarts

Risk Management

Balance tracking for drawdown monitoring
Real-time P&L calculations
Risk metrics to assess performance

📈 Sample Statistics Output

📊 Trading Statistics

💰 Balance Overview
• Initial: $1,000.00
• Current: $1,150.00  
• Total P&L: $150.00
• Total Return: 15.00%

📈 Trading Activity
• Total Trades: 25
• Buy Orders: 13
• Sell Orders: 12
• Days Active: 30

🏆 Performance Metrics
• Win Rate: 68.0%
• Profit Factor: 2.15
• Avg Win: $45.50
• Avg Loss: $28.75
• Expectancy: $6.25

📊 Risk Metrics
• Sharpe Ratio: 1.85
• Sortino Ratio: 2.41
• Max Drawdown: 8.5%
• Volatility: 12.3%
• VaR (95%): 3.2%

🎯 Best/Worst
• Largest Win: $125.00
• Largest Loss: $75.00
• Max Consecutive Wins: 5
• Max Consecutive Losses: 2

📅 Since: 2024-01-15

🔧 Files Overview

File	Purpose
`manual_trading_bot.py`	Main launcher - Start this for manual trading
`telegram_bot.py`	Telegram interface with trading commands
`trading_stats.py`	Comprehensive statistics tracking
`hyperliquid_client.py`	Hyperliquid API wrapper
`config.py`	Configuration management
`get_telegram_chat_id.py`	Helper to find your Chat ID
`trading_stats.json`	Your trading statistics (auto-created)

⚙️ Advanced Configuration

Custom Trading Symbol

DEFAULT_TRADING_SYMBOL=ETH/USDC:USDC

Adjust Default Trade Size

DEFAULT_TRADE_AMOUNT=0.01

Logging Level

LOG_LEVEL=INFO  # DEBUG, INFO, WARNING, ERROR

🔍 Troubleshooting

Bot Won't Start

# Check configuration
python -c "from config import Config; Config.validate()"

# Check Telegram setup
python get_telegram_chat_id.py

Telegram Not Responding

Verify bot token with BotFather
Ensure Chat ID is correct
Check that bot is started in Telegram

Trading Issues

Confirm sufficient balance
Check order parameters
Verify network connectivity

🌐 Network Modes

Testnet (Default)

Safe testing environment
No real money at risk
Perfect for learning

Mainnet (Production)

Real money trading
Requires explicit confirmation
Use with caution

📞 Support

This bot is designed for manual trading control via phone. All features are focused on giving you complete control over your Hyperliquid account with professional-grade statistics tracking.

For technical issues:

Check configuration with validation commands
Review log files for error details
Ensure all dependencies are installed

Happy trading! 🚀📱

README.md 7.0 KB 文件歷史 原始文件