flaviodesa/polymarket-copy-trading-bot

This is a TypeScript bot that automatically copies another trader's activity on Polymarket, an online prediction market where people bet on the outcomes of real-world events. You point the bot at a specific trader's account, and whenever that trader places a bet, the bot places the same bet from your own account. The goal is to follow a trader whose predictions you trust without having to watch the platform yourself. The bot checks Polymarket for new activity from the target trader on a configurable schedule, set to every 15 seconds by default. When it detects a trade, it mirrors it using your wallet. Two key controls limit how much money is at risk: a multiplier that scales the copied order size up or down relative to the original, and a hard dollar cap that prevents any single copied order from exceeding a set amount. A setting called trades-only mode lets you restrict copying to actual trades and skip other account events like position claims. Requirements are Node.js version 20 or newer and a funded Polymarket account. Configuration goes into a file in the project folder. The required fields are the wallet address or username of the trader to copy, your Polymarket wallet private key, and your Polymarket proxy address, which may differ from your main wallet address and is found in the Polymarket interface. The README advises starting with a low multiplier and a small per-order cap during initial testing. Because the bot polls on a timer rather than receiving instant notifications, there will always be some delay between when the target trades and when the copy order goes out. The README notes this openly and acknowledges that a real-time approach would require a different architecture. The disclaimer states the software is for educational purposes, trading involves risk, and the user is solely responsible for outcomes.