rolekkona/polymarket-arbitrage-trading-bot — explained in plain English
Analysis updated 2026-05-18
Run an automated bot that trades Polymarket's short-duration Up or Down prediction markets using a funded Polygon wallet.
Configure position sizes, risk limits, and target markets through environment variables before running the bot.
Redeem winnings from resolved prediction markets and check current holdings through included commands.
| rolekkona/polymarket-arbitrage-trading-bot | coreworxlab/caal | bkingfilm/lapian-notes | |
|---|---|---|---|
| Stars | 399 | 395 | 405 |
| Language | TypeScript | TypeScript | TypeScript |
| Setup difficulty | hard | hard | — |
| Complexity | 4/5 | 4/5 | 2/5 |
| Audience | developer | developer | writer |
Figures from each repo's GitHub metadata at analysis time.
Requires a Polygon wallet funded with USDC, a Polygon RPC endpoint, and handling a private key, the README warns it is experimental and risks real financial loss.
This repository is an automated trading bot built for Polymarket, a prediction market platform, specifically targeting its short-duration Up or Down markets, the kind that ask whether a price will be higher or lower within a short window like 15 minutes. The bot connects to Polymarket's live orderbook over a WebSocket feed, watches price movements to guess a likely direction with a confidence score attached, and then places limit orders based on that guess while trying to manage risk with configurable position limits. To run it, someone needs Node.js version 18 or newer, a Polygon blockchain wallet funded with USDC, the stablecoin used for trading, and access to a Polygon network RPC endpoint, which the bot uses to approve token spending and redeem winnings. Setup involves creating a .env configuration file with a Polygon wallet private key, the list of markets to trade, how many shares to buy per side, price precision settings, and various optional limits like a minimum balance requirement or a maximum number of buys per side. The README is explicit that this private key must never be shared with anyone. Once configured, the bot is started with a single npm command, and separate commands exist for redeeming resolved markets and checking current holdings. Internally, the code is split into a runner that handles startup checks like validating configuration, confirming balances, and syncing token allowances, a providers layer that talks to Polymarket's order book service, a security layer that checks wallet balances and manages spending allowances, and a strategy engine that resolves which market to trade and decides on prices and order placement. The README describes this software as experimental and includes a clear warning that anyone using it does so at their own risk, with only money they could afford to lose, and that the people maintaining the project are not responsible for financial losses, misconfiguration, or the bot going offline. No license is stated in the README shown.
An automated trading bot that connects a Polygon wallet to Polymarket's short-term Up or Down prediction markets to place trades.
Mainly TypeScript. The stack also includes TypeScript, Node.js, WebSocket.
Setup difficulty is rated hard, with roughly 1h+ to a first successful run.
Mainly developer.
This repo across BitVibe Labs
Don't trust strangers blindly. Verify against the repo.