alpha-vector-core/polymarket-arbitrage-trading-bot

This is an automated trading bot for Polymarket, a prediction market where you wager on whether a cryptocurrency price will be higher or lower within a chosen time window. The bot is designed for short-horizon crypto markets on Bitcoin, Ethereum, Solana, and XRP, with windows ranging from 5 minutes to 24 hours. It connects to Polymarket's central limit order book, checks live bid and ask prices every second, and submits buy and sell orders automatically based on rules you configure. A central limit order book works like a traditional stock exchange, where buyers and sellers post orders that are matched against each other. Orders in this bot are Fill-and-Kill, meaning they execute immediately at the best available price or are canceled. Your wallet balance is read directly from the blockchain rather than tracked in software memory, so the portfolio figures you see are always real. Two strategies are available. The exit-only strategy is for managing an existing position: it sells when a price ratio or time ratio threshold is crossed. The entry strategy is more complete: it buys once per market window when price and timing conditions align, exits when the price hits a configured target range, and can optionally swap to the opposite side immediately after a successful exit if the price favors that move. One feature that distinguishes this version from similar repositories is automatic handling of the authentication step. If no signature mode is forced in the environment settings, the bot tries a proxy wallet mode first, then falls back to a direct wallet mode, until authentication with Polymarket succeeds. It also automatically rolls to the next market window when the current one expires. Configuration uses a trade.toml file for strategy settings and a .env file for private keys. The README recommends starting with small trade sizes. It includes a disclaimer that automated trading in prediction markets carries real financial and regulatory risk, and that losses are possible. The full README is longer than what was shown.