mila89/polymarket-trading-bot

This repository contains an automated trading bot for Polymarket, a prediction market platform where users bet on whether the price of a cryptocurrency will go up or down within a given time window. The bot is written in TypeScript and targets the UP/DOWN markets for Bitcoin, Ethereum, Solana, and XRP, with time windows ranging from 5 minutes to 24 hours. The bot connects to Polymarket's order book (called the CLOB) and checks the current bid and ask prices once every second. It then runs one of two configurable trading strategies and places real orders on the blockchain using a Polygon wallet that holds USDC. Orders are placed as fill-and-kill, meaning each order either fills immediately at the current market price or is cancelled, with no resting orders left open. The two built-in strategies are configured via a TOML file. The first strategy is exit-only: the bot watches an existing position and sells it when the time remaining in the market window drops below a threshold or when the price moves far enough from 50/50. The second strategy adds entry logic, buying whichever side (up or down) currently has the higher price when conditions are met, and optionally swapping to the opposite side if a quick reversal signal appears after an exit. To run the bot, a user provides a private key and a Polymarket proxy wallet address in an environment file, sets their preferred strategy and order size in the configuration file, and starts it with a single command. The bot then prints live market snapshots every few seconds showing the current price ratio, time remaining, position held, and portfolio value. The project requires Node.js 20.6 or newer and actual USDC funds on the Polygon network, so this is live-money trading software, not a simulator. The README is straightforward in describing the setup process, strategy logic, and what each part of the codebase does.