predictiveflow-labs/polymarket-arbitrage-bot

This repository is a TypeScript trading bot that operates on Polymarket, a prediction market platform where users trade on the outcomes of real-world events. Specifically, it targets short-duration Up/Down markets tied to cryptocurrency prices, such as whether Bitcoin will finish higher or lower within a 5-minute or 15-minute window. The bot uses the official Polymarket order book API to poll prices, apply configurable entry and exit rules, and place orders automatically. The bot is built on Node.js 20 or newer and is configured through two files: a .env file for secrets like your wallet private key and funding address, and a trade.toml file where you set the market (coin and time window), the strategy to use, how much to trade per order, retry limits, and cooldown periods. Two strategy modes are available, called trade_1 and trade_2, which differ in their entry conditions and exit behavior. The bot runs one market window at a time. Running two separate processes with two different configs is the suggested approach for anyone wanting to watch both 5-minute and 15-minute windows simultaneously. The README is explicit that this is not a risk-free arbitrage system and that the word "arbitrage" in the name reflects search terminology rather than a strict financial definition. The bot does not implement a paired dual-leg arbitrage engine that trades two correlated windows simultaneously. It is described as automation scaffolding for experimentation, suited to developers building on top of the Polymarket CLOB API or traders running small-size experiments with strict risk controls. On the technical side, the codebase is organized into services for authentication and API access, a pricing module that polls quotes, a decision module that applies the strategy rules, and an execution module that submits orders with retry logic and human-readable error messages. Startup validates required environment variables before doing anything else. The project is licensed under ISC. The README includes a safety and compliance section noting that users are responsible for checking whether their activities comply with applicable laws and Polymarket's terms of service. The full README is longer than what was shown.