quant-alpha-systems/polymarket-trading-bot

PolyPulse is an open-source automated trading bot for Polymarket, a platform where people bet real money on whether prices of cryptocurrencies like Bitcoin, Ethereum, Solana, and XRP will go up or down within a set time window. The bot connects to Polymarket's order book, watches live bid and ask prices every second, and places buy or sell orders automatically based on rules you configure. It works with real money on the Polygon blockchain network, not a simulator. To use it, you need a Polymarket account with a proxy wallet holding USDC (a dollar-pegged cryptocurrency used on Polymarket), and a separate signing key that the bot uses to authorize trades. These credentials go into a local environment file that stays on your computer. You then edit a simple configuration file to pick which coin and time window you want to trade (for example, BTC over 5-minute windows) and how many dollars to risk per trade. The bot includes two trading strategies. The first, called "trade_1," only closes out positions you already hold when certain timing or price conditions are met, and does not open new ones. The second, called "trade_2," handles the full cycle: it enters a position once per market window based on price distance from the midpoint and how far along the time window you are, exits when price targets are hit, and can optionally flip to the opposite side immediately after selling. Both strategies are controlled through numbers in the configuration file. While the bot is running, a live terminal display refreshes every few seconds showing the current bid and ask prices, your wallet balance, whether you hold a position, and whether an order is currently being submitted. The README includes a security note recommending that you start with small trade sizes ($1 to $3) before scaling up, keep your private key out of version control, and use a wallet funded only with the amount you are willing to risk. Node.js version 20.6 or higher is required to run the project.