signal-market-engine/polymarket-trading-bot

This is an automated trading bot for Polymarket, a prediction market platform where you bet on whether a cryptocurrency will be higher or lower within a specific time window. The bot focuses on short-horizon crypto price markets for Bitcoin, Ethereum, Solana, and XRP, covering windows from 5 minutes up to 24 hours. It handles the full trading cycle automatically: discovering the active market, checking live prices every second, and placing buy or sell orders when configured rules are met. Polymarket uses a central limit order book, meaning orders are matched like a traditional exchange. This bot connects to that order book directly and reads your actual on-chain wallet balances to determine positions, rather than estimating from memory. Orders are submitted as Fill-and-Kill, meaning they execute immediately at the available price or not at all. Two trading strategies are available. The first is exit-only: it closes an existing position when either a price threshold or a time threshold is crossed, without opening new trades. The second is more active: it enters a position once per market window when a set of price and timing conditions align, exits when the price reaches a target range, and can optionally flip to the opposite side immediately after exiting if the price suggests the other direction is now favored. All configuration lives in a file called trade.toml, where you specify which strategy to use, how much to spend per trade, which coin and time window to target, and the numeric thresholds that control entries and exits. Wallet private key and funder address go in a separate environment file that should never be committed to version control. The README includes a disclaimer that this software is intended for education and research, and warns that automated trading in prediction markets can lose money quickly. It recommends starting with very small trade amounts until you understand the behavior.