🚀 Hyperliquid Trading Bot

A high-performance, production-ready trading bot for the Hyperliquid DEX built in Rust. This bot implements multiple trading strategies with comprehensive risk management and real-time market analysis.

✨ Features

🎯 Trading Strategies

DCA (Dollar Cost Averaging): Systematic investment strategy with configurable intervals
Grid Trading: Automated buy/sell orders at predetermined price levels
Momentum Trading: Technical analysis-based strategy using MACD, RSI, and moving averages

🛡️ Risk Management

Position size limits and daily loss limits
Stop-loss and take-profit automation
Real-time risk monitoring and alerts
Configurable drawdown protection

📊 Advanced Features

Real-time WebSocket market data streaming
Comprehensive logging and monitoring
Dry-run mode for strategy testing
Multiple configuration profiles (testnet/production)
Async/await architecture for high performance

🔧 Technical Highlights

Built with Rust for maximum performance and safety
Type-safe API integration with Hyperliquid
Modular strategy system for easy extension
Comprehensive error handling and recovery
Production-ready logging and monitoring

🚀 Quick Start

Prerequisites

Rust 1.70+ (Install Rust)
Hyperliquid API credentials
Git

Installation

Clone the repository

git clone https://github.com/topsecretagent007/hyperliquid-trading-bot.git
cd hyperliquid-trading-bot

Install dependencies
```
cargo build --release
```

Set up environment variables

cp env.example .env
# Edit .env with your API credentials

Configure the bot

# Edit config/default.toml for your trading preferences
nano config/default.toml

Run in dry-run mode (recommended first)
```
cargo run -- --dry-run
```

📋 Configuration

Environment Variables

Create a .env file with your Hyperliquid credentials:

HYPERLIQUID_API_KEY=your_api_key_here
HYPERLIQUID_PRIVATE_KEY=your_private_key_here
HYPERLIQUID_TESTNET=true

Configuration Files

The bot uses TOML configuration files with the following structure:

`config/default.toml` (Testnet/Safe)

[hyperliquid]
testnet = true
dry_run = true

[risk_management]
max_daily_loss = 1000.0
max_position_size = 10000.0

[strategies.dca_btc]
enabled = true
strategy_type = "dca"
symbol = "BTC"
parameters = { investment_amount = "100", interval_hours = "24" }

`config/production.toml` (Mainnet/Live)

[hyperliquid]
testnet = false
dry_run = false

[risk_management]
max_daily_loss = 500.0
max_position_size = 5000.0

🎯 Trading Strategies

1. DCA (Dollar Cost Averaging)

Systematically invests a fixed amount at regular intervals, reducing the impact of market volatility.

Configuration:

[strategies.dca_btc]
enabled = true
strategy_type = "dca"
symbol = "BTC"
parameters = {
    investment_amount = "100",    # $100 per interval
    interval_hours = "24",        # Daily investment
    max_investment = "5000",      # Maximum total investment
    lookback_period = "20"        # Price analysis period
}

Features:

Automatic investment scheduling
Price trend analysis for optimal timing
Maximum investment limits
Configurable intervals (hours)

2. Grid Trading

Places buy and sell orders at predetermined price levels to profit from market volatility.

Configuration:

[strategies.grid_eth]
enabled = true
strategy_type = "grid"
symbol = "ETH"
parameters = {
    grid_spacing = "1.0",         # 1% between levels
    position_size = "50",         # $50 per grid level
    max_levels = "10",            # 10 levels above/below
    max_investment = "3000"       # Maximum total investment
}

Features:

Automated order placement
Configurable grid spacing
Dynamic level adjustment
Risk management integration

3. Momentum Trading

Uses technical indicators (MACD, RSI, Moving Averages) to identify momentum and trend changes.

Configuration:

[strategies.momentum_sol]
enabled = true
strategy_type = "momentum"
symbol = "SOL"
parameters = {
    fast_period = "12",           # Fast EMA period
    slow_period = "26",           # Slow EMA period
    rsi_period = "14",            # RSI calculation period
    min_confidence = "0.6"        # Minimum signal confidence
}

Features:

MACD crossover detection
RSI overbought/oversold signals
Moving average trend analysis
Volume confirmation
Confidence-based position sizing

🛡️ Risk Management

Position Limits

Maximum position size per asset
Maximum total positions
Daily loss limits
Drawdown protection

Stop Loss & Take Profit

Automatic stop-loss orders
Take-profit automation
Trailing stop functionality
Risk-adjusted position sizing

Monitoring

Real-time PnL tracking
Risk metric calculations
Alert system for limit breaches
Comprehensive logging

📊 Usage Examples

Basic Usage

# Run with default configuration
cargo run

# Run with custom config
cargo run -- --config config/production.toml

# Run in dry-run mode
cargo run -- --dry-run

# Enable debug logging
cargo run -- --debug

Advanced Usage

# Production mode with custom config
cargo run --release -- --config config/production.toml

# Test specific strategy
cargo run -- --config config/test_dca.toml

# Monitor with verbose logging
RUST_LOG=debug cargo run -- --debug

🔧 Development

Project Structure

hyperliquid-trading-bot/
├── src/
│   ├── main.rs              # Entry point
│   ├── lib.rs               # Library exports
│   ├── api/                 # Hyperliquid API client
│   ├── config.rs            # Configuration management
│   ├── models.rs            # Data models
│   ├── strategies/          # Trading strategies
│   │   ├── dca.rs          # DCA strategy
│   │   ├── grid.rs         # Grid trading
│   │   ├── momentum.rs     # Momentum strategy
│   │   └── base.rs         # Strategy traits
│   ├── trading_bot.rs       # Main bot logic
│   ├── utils.rs             # Utility functions
│   └── error.rs             # Error handling
├── config/                  # Configuration files
├── logs/                    # Log files
└── Cargo.toml              # Dependencies

Adding New Strategies

Implement the Strategy trait in src/strategies/
Add strategy to the bot initialization in trading_bot.rs
Update configuration schema
Add tests and documentation

Testing

# Run all tests
cargo test

# Run specific test
cargo test test_dca_strategy

# Run with coverage
cargo test -- --nocapture

📈 Performance

Latency: Sub-millisecond order processing
Throughput: Handles 1000+ orders per second
Memory: < 50MB RAM usage
CPU: Optimized for low CPU usage
Reliability: 99.9% uptime with proper configuration

🚨 Safety & Security

Security Features

Private key encryption
Secure API communication
Input validation and sanitization
Rate limiting and error handling

Safety Measures

Dry-run mode for testing
Position size limits
Daily loss limits
Automatic stop-loss
Emergency stop functionality

📝 Logging & Monitoring

Log Levels

ERROR: Critical errors requiring attention
WARN: Warnings and potential issues
INFO: General information and trade execution
DEBUG: Detailed debugging information

Log Files

logs/bot.log: Main application log
logs/errors.log: Error-specific log
logs/trades.log: Trade execution log

Monitoring

Real-time PnL tracking
Strategy performance metrics
Risk metric monitoring
System health checks

🤝 Contributing

We welcome contributions! Please see our Contributing Guidelines for details.

Development Setup

Fork the repository
Create a feature branch
Make your changes
Add tests
Submit a pull request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

⚠️ Disclaimer

This software is for educational and research purposes only. Trading cryptocurrencies involves substantial risk of loss and is not suitable for all investors. Past performance is not indicative of future results. Always do your own research and consider your risk tolerance before trading.

📞 Support

GitHub Issues: Report bugs and request features
Telegram: @topsecretagent_007
Email: Contact via GitHub

🙏 Acknowledgments

Hyperliquid team for the excellent DEX platform
Rust community for the amazing ecosystem
All contributors and testers

Made with ❤️ by topsecretagent007

Happy Trading! 🚀📈

Name		Name	Last commit message	Last commit date
config		config
docs		docs
examples		examples
scripts		scripts
src		src
.gitignore		.gitignore
CONTRIBUTING.md		CONTRIBUTING.md
Cargo.toml		Cargo.toml
LICENSE		LICENSE
README.md		README.md
env.example		env.example

Latest commit

History

Folders and files

Repository files navigation

🚀 Hyperliquid Trading Bot

✨ Features

🎯 Trading Strategies

🛡️ Risk Management

📊 Advanced Features

🔧 Technical Highlights

🚀 Quick Start

Prerequisites

Installation

📋 Configuration

Environment Variables

Configuration Files

config/default.toml (Testnet/Safe)

config/production.toml (Mainnet/Live)

🎯 Trading Strategies

1. DCA (Dollar Cost Averaging)

2. Grid Trading

3. Momentum Trading

🛡️ Risk Management

Position Limits

Stop Loss & Take Profit

Monitoring

📊 Usage Examples

Basic Usage

Advanced Usage

🔧 Development

Project Structure

Adding New Strategies

Testing

📈 Performance

🚨 Safety & Security

Security Features

Safety Measures

📝 Logging & Monitoring

Log Levels

Log Files

Monitoring

🤝 Contributing

Development Setup

📄 License

⚠️ Disclaimer

📞 Support

🙏 Acknowledgments

About

Topics

Resources

Contributing

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages

`config/default.toml` (Testnet/Safe)

`config/production.toml` (Mainnet/Live)