🚀 Hunter: The Autonomous Crypto Trader

Hunter is a quant level crypto trading bot executing real on-chain trades with live PnL, smart token scanning, microstructure analysis, and adaptive risk control. Uses weighted multi-factor analysis and heuristic algorithms for intelligent decision-making. Updated in real time. If you find this project useful, drop a ⭐️ to support it.

⚠️ IMPORTANT DISCLAIMER

Cryptocurrency trading involves significant risk of loss. Never invest more than you can afford to lose. The developers are not responsible for any financial losses incurred from using this bot.

🔄 How It Works

1. Token Selection 🔍

The bot continuously scans DexScreener for trending tokens across Solana and Base using configurable discovery settings. It filters out low-quality tokens by requiring:

• Minimum $250k daily volume (configurable)
• Minimum $250k liquidity (configurable)
• Active trading activity
• No stablecoins or wrapped tokens

Top candidates are ranked by volume and passed to the analysis system for deeper evaluation.

2. Entry Decision ✅

Before entering any trade, tokens must pass multiple analysis-driven checks:

• Quality Score ≥ 60% (configurable, default 60%; combines technical analysis, price prediction, risk, and market metrics; sentiment is not used in scoring)
• Success Probability ≥ 60% (prediction of profitable outcome based on weighted analysis)
• Holder Concentration < 50% (configurable, default 50%; blocks tokens where top 10 holders own 50% or more; 45-50% is yellow zone with reduced position size)
• Order-Flow Defense (Solana) - Blocks tokens with suspicious trading patterns:
  • Minimum 55% buy dominance (more buyers than sellers)
  • Maximum 20% from single wallet (prevents single-wallet pumps)
  • Minimum 12 unique buyers (ensures diverse participation)
  • Largest buy ≤ 4x median (prevents whale manipulation)
  • Minimum $15k buy volume in last 2 minutes
  • Minimum 25 total trades in lookback window
• Hyperactivity Filter - Blocks tokens with extremely high transaction volume:
  • Detects tokens with >1000 transactions/hour or <1 hour of time coverage
  • Prevents excessive API calls and filters out bot/wash trading activity
  • Tokens are blocked for 1 hour cooldown period after detection
• Risk Score ≤ 50% (lower is safer)
• Recommendation = "buy" or "weak_buy" with ≥70% confidence (regular buy) or ≥60% confidence (weak buy)
• Momentum Requirements (candle-based only):
  • Minimum momentum from validated 15m candles (computed from Helius DEX swap data)
  • Candles are required for buy signal; no external momentum fallback
• Volume Momentum: Volume must be increasing (if volume change data available; requires 5% increase in 1h)
• RSI Filter: Rejects overbought tokens (RSI > 70)
• VWAP Entry Filter: Requires price to be at or above VWAP (Volume Weighted Average Price):
  • Hard blocks entries below VWAP (requires buying strength)
  • Allows entries near VWAP (within 2% tolerance - preferred pullback zone)
  • Allows entries extended above VWAP (>5% above) but requires extra momentum confirmation
• 15-Minute Candle Validation: For tokens without strong fundamentals, validates 15-minute candlestick data from Helius DEX swaps (minimum 12 candles required, ideal 16+)

Only tokens passing all criteria are considered for trading.

3. Exit Strategy 💰

The bot continuously monitors all open positions and automatically sells when:

• Take Profit is hit: 10% gain (default, can be dynamic based on market conditions, up to 20% for high-quality tokens)
• Stop Loss is triggered: 3% loss (with 15% slippage buffer for execution)
• Trailing Stop activates: Locks in profits if price drops 5% from peak (configurable, default 5%)
• Volume Exit: Exits if trading volume drops 50% from entry average (requires 1%+ profit, requires 2 confirmations to avoid false exits)
• Technical Exit Signals: Exits based on technical indicators when profitable (minimum 2% profit required, configurable):
  • RSI Overbought: RSI > 70 (configurable threshold)
  • MACD Bearish Crossover: MACD line crosses below signal line
  • Bollinger Bands: Price at 85%+ of upper band (configurable threshold)
  • VWAP Below + Declining Volume: Price below VWAP with declining volume trend
• Momentum Decay Exit: Exits if momentum drops below threshold (0.5% default) with consecutive confirmations (2 checks default)
• Structure Failure Exit: Exits if price structure breaks down (2% break threshold, minimum 5 minutes age)
• Partial Take-Profit Manager: Staged profit-taking with adaptive trailing stops (sells 50% at first target, manages remaining position)
• Token Delisted: Auto-sells if token becomes untradeable (detected after 5 consecutive price fetch failures)

All positions are monitored in real-time (every 30 seconds), and exits execute automatically on-chain with comprehensive verification.

---

🎯 Advanced Analysis Features

🧠 Core Analysis Systems

• 🔍 Market Microstructure Analyzer - Real-time order book analysis, trade flow patterns, liquidity analysis, whale activity detection, market maker identification, and manipulation detection
• ⚡ Trade Execution Optimizer - Intelligent execution timing, optimal DEX/router selection, slippage minimization, gas optimization, and success prediction
• 📊 Sentiment Analysis - Multi-source sentiment analysis combining social media, news, market, and technical sentiment using weighted scoring
• 🎯 Market Regime Detection - Rule-based market condition detection (bull, bear, sideways, volatile, recovery) with adaptive strategy
• 🔮 Price Prediction - Advanced price prediction using technical indicators (RSI, MACD, Bollinger Bands, VWAP), volume profiles, and price action patterns for predicting token success probability and optimal entry/exit timing
• 📈 Portfolio Optimization - Modern portfolio theory optimization for capital allocation, risk-adjusted returns, and diversification
• 🛡️ Risk Assessment - Multi-factor risk scoring using weighted analysis of volume, liquidity, momentum, and market conditions
• 🔍 Pattern Recognition - Candlestick pattern detection using OHLC analysis, support/resistance identification, and momentum signals
• 🧠 Market Intelligence Aggregator - Comprehensive market intelligence analysis including news sentiment, social media intelligence, influencer tracking, and market events
• 🔮 Predictive Analytics Engine - Advanced price movement prediction using technical analysis, sentiment analysis, volume analysis, and correlation analysis
• 🎯 Dynamic Strategy Selector - Adaptive strategy selection that automatically switches between momentum, mean reversion, breakout, scalping, swing, and trend-following strategies based on market conditions
• 🛡️ Risk Prediction & Prevention System - Comprehensive risk protection including flash crash detection, rug pull prevention, manipulation detection, liquidity drain monitoring, correlation breakdown analysis, and black swan event detection
• 🔄 Market Regime Transition Detector - Real-time market regime change detection for optimal strategy switching and risk management
• 💧 Liquidity Flow Analyzer - Advanced liquidity flow analysis for market imbalance detection and optimal entry/exit timing
• ⏰ Multi-Timeframe Analysis Engine - Comprehensive multi-timeframe analysis integrating data from multiple timeframes for robust market view
• 🔄 Market Cycle Predictor - Market cycle prediction for strategic positioning and anticipating major market shifts
• 🛡️ Drawdown Protection System - Advanced drawdown protection with portfolio analysis, individual trade analysis, and market condition monitoring
• 📊 Performance Attribution Analyzer - Performance driver identification for strategy optimization and performance improvement
• 🔍 Market Anomaly Detector - Unusual market condition detection for opportunity and risk identification
• ⚖️ Portfolio Rebalancing Engine - Optimal portfolio allocation using modern portfolio theory for risk-adjusted returns and diversification

🌐 Multi-Chain Trading

• Real trading on Solana (Phantom) and Base (MetaMask)
• DEX Integration - Uniswap V3 (Base), Jupiter + Raydium (Solana)
• Chain-Specific Optimization - Tailored strategies for each blockchain
• Robust Fallbacks on Solana - Jupiter as primary with Raydium fallback for reliability
• USDC Trading on Solana - Uses USDC as base currency for Solana trades (configurable)

📊 Advanced Analytics & Performance

• Quality-Based Position Sizing - Position sizes scale with token quality (1.2x-2.0x multipliers) - higher quality tokens get larger positions within tier limits
• Performance Tracking - Comprehensive PnL analysis, win rate tracking, and quality tier performance
• Real-time Insights - Live market analysis, execution optimization, and risk assessment
• Quality Scoring System - 0-100 quality scores combining traditional metrics with weighted multi-factor analysis
• Efficiency Optimizations - Early filtering (60-80% fewer AI calls), batch processing (2x faster), and adaptive timing

🛡️ Risk Management & Safety

• Enhanced Risk Assessment - Multi-factor risk analysis using weighted scoring
• Order-Flow Defense (Solana) - Real-time analysis of swap transactions to block:
  • Single-wallet pumps (one wallet dominating buys)
  • Wash trading (fake volume patterns)
  • Fake momentum spikes (artificial price movements)
  • Whale manipulation (disproportionate large buys)
  • Uses indexed swap events from local database (zero API calls)
• Manipulation Detection - Advanced detection of pump/dump schemes, wash trading, and spoofing
• Whale Activity Monitoring - Real-time whale trade detection and impact analysis
• Market Maker Intelligence - Leverages market maker presen