judithsulfan/trading-bot

This is a TypeScript bot that trades automatically on Polymarket, a prediction market platform where users bet on whether prices will go up or down. Specifically, it targets the UP/DOWN crypto markets on Polymarket: short-window bets on whether Bitcoin, Ethereum, Solana, or XRP will be higher or lower at the end of a chosen time period (ranging from 5 minutes to 24 hours). The bot connects to Polymarket's order book, checks live prices every second, and places buy or sell orders when your configured rules say to. The bot works on the Polygon blockchain and requires two wallets: a signer wallet (an ordinary private key that signs the orders) and a proxy wallet (a Gnosis Safe wallet that actually holds the USDC funds). Both addresses need to be set in a .env file before the bot will run. You also need USDC on Polygon in the proxy wallet to fund trades. Strategy configuration lives in a trade.toml file. Two strategies are available. The first, called trade_1, is exit-only: it does not open new positions, but it will close an existing one if the market is running out of time or if the price has moved far enough from 50/50. The second, trade_2, handles the full cycle: it can open a position once during a market window when price and timing conditions are met, close it on exit conditions, and optionally swap immediately to the opposite side if the price is still moving after a sale. The project uses Node.js 20.6 or newer and is written in TypeScript. Running npm run dev starts the bot in development mode, npm run build and npm start compile and run the production version. During operation, the terminal prints a live status line every few seconds showing the current market state, your on-chain balances, and whether the bot is idle or has an order in flight. The README includes a security note recommending a dedicated signer key and only funding the proxy wallet with capital you can afford to lose. It also carries a disclaimer that automated trading carries financial and regulatory risk, and the software is provided for educational and research purposes only.