signaltradinglab/world-cup-2026-arbitrage-trading-bot

This is a command-line bot that scans Polymarket's FIFA World Cup 2026 prediction markets for arbitrage opportunities. Polymarket is a prediction market platform where people buy and sell tokens representing yes or no outcomes for real-world events. The bot's premise is a mathematical property of these markets: a YES token and a NO token for the same binary event always pay out a combined total of $1.00 at resolution. If you can buy both for less than $1.00 combined, you lock in a guaranteed profit regardless of the outcome. The bot pulls live market prices from Polymarket's APIs and continuously checks whether any World Cup market has that gap. It supports two strategies: the basic one for two-outcome markets (buy both YES and NO when combined cost is under $1.00), and one for multi-outcome markets like "World Cup Winner" where buying YES on every team has the same property when the full set costs less than $1.00. By default the bot runs in dry-run mode, which simulates trades without touching real money. To switch to live trading you provide a private key and wallet address in the configuration file, then implement the actual order execution code in a placeholder file the project leaves for you. The README notes that Polymarket has geographic restrictions and advises users to check their terms of service before trading. Settings can be changed while the bot is running without restarting it, including the minimum profit margin to act on, the maximum position size per trade, and how frequently to scan. An optional Redis connection lets the bot cache market data and persist settings between runs. Installation requires Node.js 18 or later. Running npm install followed by npm start is all it takes to start scanning in dry-run mode.