How minculusofia-wq/scanner-polymarket-bot-automatique works
Polymarket Scanner + Bot is a market-opportunity dashboard and automated trading system. Users inspect multi-strategy signals and quantitative analyses, then configure or operate the bot in paused, semi-automatic, or full-automatic mode; the bot scans, evaluates risk, executes trades, and manages positions and exits. The graph includes the documented whale, arbitrage, fade, Monte Carlo, volume-spike, and combined strategies, plus news and history capabilities. Some feature links are documented rather than visible in sampled call sites; those links cite the README.
Main entry points: bot_engine.py Bot Orchestrator · signal_scanner.py Unified Scanner · page.tsx Scanner Dashboard · trading_bot.py Bot API
Components 34
Dashboard
- Scanner Dashboard
frontend/src/app/page.tsx - Bot Controls
frontend/src/components/TradingBotPanel.tsx - Live Updates
frontend/src/hooks/useWebSocket.ts
Opportunity Scanner
- Unified Scanner
backend/app/services/trading/signal_scanner.py - Whale Detection
backend/app/services/whale/detector.py - Whale Tracking
backend/app/services/whale_tracker.py - Arbitrage and Fade
- Volume Analysis
backend/app/services/volume/analyzer.py - Monte Carlo Analysis
backend/app/services/monte_carlo/calculator.py - Combined Signals
backend/app/services/signals/combiner.py - News Aggregation
backend/app/services/news/aggregator.py - Market Data Client
backend/app/services/polymarket/client.py
Automated Trading
- Bot Orchestrator
backend/app/services/trading/bot_engine.py - Confluence Detection
backend/app/services/trading/confluence_detector.py - Market Regime
backend/app/services/trading/market_regime.py - Entry Optimizer
backend/app/services/trading/entry_optimizer.py - Smart Sizing
backend/app/services/trading/smart_sizer.py - Risk Manager
backend/app/services/trading/risk_manager.py - Strategy Performance
backend/app/services/trading/strategy_performance.py - Signal Feedback
backend/app/services/trading/feedback_loop.py - Order Executor
backend/app/services/trading/executor.py - Position Manager
backend/app/services/trading/position_manager.py - Exit Manager
backend/app/services/trading/exit_manager.py
API and Persistence
- Signal API
backend/app/api/signals.py - Bot API
backend/app/api/trading_bot.py - Market API
backend/app/api/markets.py - News API
backend/app/api/news.py - History API
backend/app/api/history.py - Monte Carlo API
backend/app/api/monte_carlo.py - Volume API
backend/app/api/volume.py - Whale API
backend/app/api/whales.py - Database
backend/app/core/database.py
Other components
- User
- Polymarket APIs
Connections 43
- User → Scanner Dashboard: views markets
- User → Bot Controls: controls bot
- Scanner Dashboard → Signal API: requests signals
- Bot Controls → Bot API: controls bot
- Scanner Dashboard → Market API: requests markets
- Scanner Dashboard → Monte Carlo API: requests analysis
- Scanner Dashboard → News API: requests news
- Scanner Dashboard → History API: requests history
- Live Updates → Scanner Dashboard: provides updates
- Bot API → Bot Orchestrator: controls
backend/app/api/trading_bot.py - Bot API → Position Manager: reads positions
backend/app/api/trading_bot.py - Bot API → Order Executor: checks executor
backend/app/api/trading_bot.py - Signal API → Whale Tracking: uses tracking
backend/app/api/signals.py - Monte Carlo API → Monte Carlo Analysis: calculates edge
backend/app/api/monte_carlo.py - News API → News Aggregation: aggregates news
backend/app/api/news.py - Whale API → Whale Tracking: reads tracking
backend/app/api/whales.py - History API → Database: reads history
backend/app/api/history.py - Unified Scanner → Whale Detection: scans whales
backend/app/services/trading/signal_scanner.py - Unified Scanner → Arbitrage and Fade: scans strategies
backend/app/services/trading/signal_scanner.py - Unified Scanner → Volume Analysis: scans volume
backend/app/services/trading/signal_scanner.py - Unified Scanner → Monte Carlo Analysis: calculates edge
backend/app/services/trading/signal_scanner.py - Unified Scanner → Combined Signals: scans combined
- Unified Scanner → Market Data Client: fetches markets
backend/app/services/trading/signal_scanner.py - Whale Detection → Market Data Client: fetches trades
backend/app/services/whale/detector.py - Volume Analysis → Market Data Client: fetches market data
backend/app/services/volume/analyzer.py - Market Data Client → Polymarket APIs: requests data
backend/app/services/polymarket/client.py - Bot Orchestrator → Unified Scanner: runs scans
backend/app/services/trading/bot_engine.py - Bot Orchestrator → Confluence Detection: detects agreement
backend/app/services/trading/bot_engine.py - Bot Orchestrator → Market Regime: weights signals
backend/app/services/trading/bot_engine.py - Bot Orchestrator → Entry Optimizer: validates entries
backend/app/services/trading/bot_engine.py - Bot Orchestrator → Smart Sizing: sizes positions
backend/app/services/trading/bot_engine.py - Bot Orchestrator → Risk Manager: checks risk
backend/app/services/trading/bot_engine.py - Bot Orchestrator → Strategy Performance: tracks performance
backend/app/services/trading/bot_engine.py - Bot Orchestrator → Signal Feedback: updates feedback
- Bot Orchestrator → Order Executor: executes orders
backend/app/services/trading/bot_engine.py - Bot Orchestrator → Position Manager: manages positions
backend/app/services/trading/bot_engine.py - Bot Orchestrator → Exit Manager: manages exits
backend/app/services/trading/bot_engine.py - Exit Manager → Order Executor: places exit orders
backend/app/services/trading/exit_manager.py - Exit Manager → Position Manager: reads positions
backend/app/services/trading/exit_manager.py - Order Executor → Polymarket APIs: places orders
- History API → Database: queries store
backend/app/api/history.py - Position Manager → Database: stores positions
backend/app/services/trading/position_manager.py - Risk Manager → Database: reads exposure
backend/app/services/trading/risk_manager.py