explaingit

u1acodefinance/polymarket-v2-arbitrage-bot

Analysis updated 2026-05-18

106TypeScriptAudience · developerComplexity · 4/5LicenseSetup · hard

TLDR

An automated trading bot for Polymarket's five-minute prediction markets that places YES or NO orders based on configurable price and timing rules.

Mindmap

mindmap
  root((polymarket bot))
    What it does
      Watches order book
      Times market rounds
      Places YES or NO orders
      Configurable entry rules
    Tech stack
      TypeScript
      Node.js
      Polygon wallet
    Use cases
      Short-duration trading
      Multi-asset markets
      Strategy testing
    Risks
      High risk strategy
      Polling not WebSocket
      Requires signed orders

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Automate entry into short-duration Polymarket prediction markets based on price and countdown timing rules.

USE CASE 2

Configure per-asset trading strategies for bitcoin, ethereum, solana, or XRP markets.

USE CASE 3

Run a repeatable price-check and order-placement cycle from the command line for testing trading strategies.

What is it built with?

TypeScriptNode.js

How does it compare?

u1acodefinance/polymarket-v2-arbitrage-botnewideas99/open-dungeonbigfrankykevin/sportsbook-bet365
Stars106106105
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyhardmoderatemoderate
Complexity4/53/53/5
Audiencedevelopervibe coderdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires a funded Polygon wallet with USDC and a Polymarket account with API access.

Permissive open-source license, use freely for any purpose, including commercial use.

In plain English

This project is a trading bot built for Polymarket, a prediction market platform. It focuses specifically on very short duration markets that resolve every five minutes, and it tries to place trades automatically based on price and timing rules you configure ahead of time. The bot watches a market's order book once every second, checking the current price and how many seconds remain before the round ends. You set entry rules in a config file: a minimum and maximum price, a window of seconds before round end when the bot is allowed to act, and how much money to put into each trade. When the price and timing match your rules, the bot automatically places a YES or NO order on your behalf. It is built to work across several assets, including bitcoin, ethereum, solana, and XRP markets, and the code is organized so new strategies can be added later. To run it, you need Node.js version 20 or newer, a Polygon network wallet funded with USDC, and a Polymarket account with API access. Setup involves copying an example environment file and filling in your wallet's private key, a proxy wallet address, and a connection URL for the Polygon network, then editing a separate configuration file to describe your trading strategy. Once configured, the bot runs from the command line and repeats its check, decide, and trade cycle continuously. The README includes several warnings worth taking seriously: orders require a specific cryptographic signing method, your wallet needs enough USDC to cover trades, the bot checks prices by repeatedly asking the server rather than using a live data stream, and this is described as a high risk strategy that should be tested carefully before using real money. The author also lists possible future improvements, such as switching to a live data feed, automatically canceling old unfilled orders, and supporting multiple markets at once. The project is released under the MIT license, which allows free use, including commercial use.

Copy-paste prompts

Prompt 1
Explain how the entry rules in this Polymarket bot's config.toml file work, including the price thresholds and remaining-seconds settings.
Prompt 2
How do I set up a Polygon wallet with USDC and connect it to this bot's .env file?
Prompt 3
Modify this bot to use a WebSocket connection instead of polling the order book every second.
Prompt 4
Write a script that adds automatic cancellation of stale unfilled orders to this trading bot.

Frequently asked questions

What is polymarket-v2-arbitrage-bot?

An automated trading bot for Polymarket's five-minute prediction markets that places YES or NO orders based on configurable price and timing rules.

What language is polymarket-v2-arbitrage-bot written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js.

What license does polymarket-v2-arbitrage-bot use?

Permissive open-source license, use freely for any purpose, including commercial use.

How hard is polymarket-v2-arbitrage-bot to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is polymarket-v2-arbitrage-bot for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.