How bingkltech/polymarket-trading-bot works
This is a Polymarket automated trading platform: configured strategies evaluate market data, produce orders, pass wallet-specific risk checks, and execute in paper or live wallets; the dashboard exposes trading and whale activity. The map retains the documented strategy families, whale discovery/copy simulation, learning, and reporting capabilities. Source excerpts and the SOURCE INDEX support the implementation links shown; README links cover documented workflows. Several feature implementations were not sampled, so their internal connections are omitted.
Main entry points: registry.ts Strategy registry · engine.ts Trading engine · whale_service.ts Whale service · orderbook_stream.ts Orderbook stream
Components 33
Trading runtime
- Config loading
src/core/config_loader.ts - Trading engine
src/core/engine.ts - Scheduler
src/core/scheduler.ts
Market data
- Market fetcher
src/data/market_fetcher.ts - CLOB fetcher
src/data/clob_fetcher.ts - Orderbook stream
src/data/orderbook_stream.ts
Strategies
- Strategy registry
src/strategies/registry.ts - Strategy interface
src/strategies/strategy_interface.ts - Arbitrage strategies
src/strategies/arbitrage/cross_market_arbitrage.ts - Mispricing strategy
src/strategies/arbitrage/mispricing_detector.ts - Convergence strategy
src/strategies/convergence/filtered_high_prob_convergence.ts - Market making
src/strategies/market_making/spread_strategy.ts - Momentum strategy
src/strategies/trend/momentum_strategy.ts - AI forecast
src/strategies/research_ai/ai_forecast_strategy.ts - Web research
src/strategies/research_ai/web_research_pipeline.ts - Copy strategy
src/strategies/copy_trading/copy_trade_strategy.ts - Custom strategy
src/strategies/custom/user_defined_strategy.ts - Strategy learning
src/learning/critic.ts - Learning memory
src/learning/memory_bank.ts
Risk and execution
- Wallet manager
src/wallets/wallet_manager.ts - Paper wallet
src/wallets/paper_wallet.ts - Live wallet
src/wallets/polymarket_wallet.ts - Paper fill simulator
src/paper_trading/fill_simulator.ts - Risk engine
src/risk/risk_engine.ts - Kill switch
src/risk/kill_switch.ts - Order router
src/execution/order_router.ts - Trade executor
src/execution/trade_executor.ts
Whales and observability
- Whale service
src/whales/whale_service.ts - Whale scanner
src/whales/whale_scanner.ts - Whale ingestion
src/whales/whale_ingestion.ts - Dashboard server
src/reporting/dashboard_server.ts
Other components
- Operator
- Polymarket APIs
Connections 41
- Operator → Config loading: configures
- Config loading → Trading engine: starts
src/cli.ts - Trading engine → Scheduler: starts
src/core/engine.ts - Trading engine → Orderbook stream: starts
src/core/engine.ts - Trading engine → Strategy registry: resolves strategy
src/core/engine.ts - Trading engine → Wallet manager: manages wallets
src/core/engine.ts - Trading engine → Strategy interface: runs
src/core/engine.ts - Market fetcher → Polymarket APIs: fetches markets
- CLOB fetcher → Polymarket APIs: fetches books
src/data/clob_fetcher.ts - Orderbook stream → Market fetcher: uses
src/data/orderbook_stream.ts - Orderbook stream → CLOB fetcher: uses
- Trading engine → Orderbook stream: reads markets
src/core/engine.ts - Strategy registry → Arbitrage strategies: registers
src/strategies/registry.ts - Strategy registry → Mispricing strategy: registers
src/strategies/registry.ts - Strategy registry → Convergence strategy: registers
src/strategies/registry.ts - Strategy registry → Market making: registers
src/strategies/registry.ts - Strategy registry → Momentum strategy: registers
src/strategies/registry.ts - Strategy registry → AI forecast: registers
src/strategies/registry.ts - Strategy registry → Copy strategy: registers
src/strategies/registry.ts - Strategy registry → Custom strategy: registers
src/strategies/registry.ts - AI forecast → Web research: uses research
- Strategy interface → Strategy learning: reads weights
src/strategies/strategy_interface.ts - Strategy learning → Learning memory: reads memories
src/learning/critic.ts - Trading engine → Order router: routes orders
src/core/engine.ts - Order router → Wallet manager: gets wallet
src/execution/order_router.ts - Order router → Risk engine: checks order
src/execution/order_router.ts - Risk engine → Kill switch: checks switch
src/risk/risk_engine.ts - Order router → Trade executor: executes approved
src/execution/order_router.ts - Wallet manager → Paper wallet: creates paper
src/wallets/wallet_manager.ts - Wallet manager → Live wallet: creates live
src/wallets/wallet_manager.ts - Paper wallet → Paper fill simulator: simulates fills
src/wallets/paper_wallet.ts - Paper wallet → Orderbook stream: uses prices
src/wallets/paper_wallet.ts - Live wallet → Polymarket APIs: places trades
- Operator → Whale service: manages tracking
- Whale service → Whale scanner: starts scanner
src/whales/whale_service.ts - Whale service → Whale ingestion: uses ingestion
src/whales/whale_service.ts - Whale service → Whale scanner: coordinates discovery
src/whales/whale_service.ts - Whale service → Copy strategy: feeds copy trading
- Operator → Dashboard server: views dashboard
- Dashboard server → Wallet manager: reads wallets
src/reporting/dashboard_server.ts - Dashboard server → Whale service: shows whale data
src/cli.ts