alpha-vector-core/polymarket-trading-bot

Polymarket is a prediction market where traders take positions on whether crypto assets like Bitcoin or Ethereum will finish higher or lower over a set time window. This TypeScript repository is an open-source starter for automating those trades using Polymarket's central limit order book and real on-chain balances. The bot reads a configuration file called trade.toml, connects to the Polygon blockchain, and polls live bid and ask prices every second. Orders are submitted as Fill-and-Kill market orders, meaning they execute immediately or cancel with no resting limit orders left in the book. Your actual crypto wallet balance is checked after every trade so the numbers always reflect real on-chain state. Two strategies are included. The first, trade_1, is passive: it only exits an existing position when the market nears its close time or when the price deviates enough from the midpoint. The second, trade_2, runs a full entry and exit cycle. It buys the UP or DOWN side once per window when timing and price conditions match, then sells when the price hits a configured range. After a successful exit, an optional emergency swap can immediately buy the opposite side if the market looks favorable. Configuration is done through environment variables for your private key and wallet address, and through trade.toml for strategy choice, trade size in dollars, coin selection, and time period. Supported coins are Bitcoin, Ethereum, Solana, and XRP across periods from 5 minutes to 24 hours. The five-minute window is currently wired for Bitcoin only. The README suggests starting with one to three dollars per trade until you trust the setup. Running the bot requires Node.js 20 or later and USDC in a Polygon wallet. The repository is licensed under ISC and carries a disclaimer that it is for education and research only, with no guarantee against financial loss.