core-trading/world-cup-trading-bot-ts

This repository is a TypeScript command-line bot that automates copy trading on Polymarket, a prediction market platform where users bet on real-world outcomes using cryptocurrency. The bot is built specifically around FIFA World Cup 2026 match markets, though it can work on other Polymarket markets as well. The core idea is to watch the on-chain activity of wallets you designate as leaders (called whale wallets or super traders), and automatically place matching trades on your own account when those wallets make moves. You configure which wallets to follow, and the bot polls for new activity at a set interval. Four copy strategies are available. The first mirrors trades at a fixed fraction of the leader position size. The second uses a fixed USD amount per copied trade regardless of the leader amount. The third mirrors a percentage of the leader trade size. The fourth only copies trades when the leader position is at or above a threshold you set, then applies a scaling factor. The bot runs as an interactive CLI with a menu. From that menu you can start and stop the copy engine, adjust trade size and strategy, add or remove leader wallets (including importing from the Polymarket leaderboard), check status, and place manual buys on the Draw outcome for specific World Cup matches. A dry-run mode lets you see what the bot would do without committing real funds. Configuration is split between a TOML file (for trade size, strategy, and other settings) and environment variables (for your private key, wallet addresses, and Redis connection details). Redis is optional and used to persist a record of already-seen leader trades across restarts, so the bot does not repeat trades if it is restarted. The README includes a disclaimer noting that prediction market trading carries financial risk, and that Polymarket has geographic restrictions that users must check before connecting.