quant-alpha-systems/polymarket-arbitrage-trading-bot

This is an automated trading bot for Polymarket's short-horizon cryptocurrency prediction markets. On Polymarket, users can bet on whether the price of Bitcoin, Ethereum, Solana, or XRP will be higher or lower than its current price after a fixed time window, typically 5 minutes, 15 minutes, 1 hour, 4 hours, or 24 hours. This bot connects to Polymarket's order book, checks prices every second, and places real buy or sell orders automatically based on rules you configure. The bot is built in TypeScript and runs on Node.js. It uses Polymarket's own client library to authenticate, retrieve market information, and submit orders. Trades happen on the Polygon blockchain, and the bot reads your actual wallet balance from the blockchain rather than tracking a simulated portfolio. Orders are submitted as fill-and-kill, meaning each order either fills immediately at the available price or is cancelled, with no leftover open orders sitting in the book. There are two trading strategies to choose from. The first is an exit-only mode for when you already hold a position and just want rules to close it: sell when a certain amount of time has passed in the current window, or when the market price has moved far enough from 50/50. The second strategy adds an entry step: the bot takes a new position once per window if the price is within a range you specify and the window is still early enough, then exits when your target conditions are met. There is also an optional emergency swap feature that immediately takes the opposite side after an exit if the price is in a favorable zone. Configuration is split between a .env file for your wallet credentials (private key and funder address) and a trade.toml file for strategy parameters: which coin and time window to trade, how much USD to put in per trade, and the specific price and timing thresholds that trigger entries and exits. Invalid configuration is caught at startup before any trading begins. This is live trading software that spends real money from a funded Polygon wallet. The README includes a disclaimer that it is not a simulator and that trading prediction markets carries financial risk.