whatisgithub

What is polymarket-arbitrage-bot-v2?

windowsmarketlab/polymarket-arbitrage-bot-v2 — explained in plain English

Analysis updated 2026-05-18

181TypeScriptAudience · developerComplexity · 4/5LicenseSetup · hard

In one sentence

A TypeScript trading bot that automatically places bets on Polymarket's crypto up-or-down prediction markets based on configured rules.

Mindmap

mindmap
  root((Polymarket Arbitrage Bot))
    What it does
      Watches crypto markets
      Places automatic trades
      Uses CLOB V2
    Tech stack
      TypeScript
      Node.js
      Polymarket SDK
    Use cases
      BTC ETH SOL XRP markets
      Rule based entries
      Live order book data
    Audience
      Crypto traders
    Risk
      Real money orders
      Volatile markets

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

Automatically enter Bitcoin, Ethereum, Solana, or XRP up-or-down markets when configured price and timing rules match.

USE CASE 2

Stream live order book and price data for a chosen Polymarket market.

USE CASE 3

Test trading rules with small position sizes before running unattended.

USE CASE 4

Log runtime output to a file for later review of trading decisions.

What is it built with?

TypeScriptNode.jsPolymarket CLOB V2

How does it compare?

windowsmarketlab/polymarket-arbitrage-bot-v2locoremind/locoagentbinghe1980/ai-canvas
Stars181181182
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyhardhardmoderate
Complexity4/54/52/5
Audiencedeveloperdeveloperdesigner

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 in pUSD, a Polygon RPC endpoint, and Polymarket CLOB API access before it can trade.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

Polymarket Arbitrage Bot V2, named Crypto Prediction Executor in its README, is a TypeScript trading tool for short term crypto prediction markets on Polymarket. It watches live price feeds and order book data for Bitcoin, Ethereum, Solana, and XRP up or down markets, checks the data against rules the user configures, and automatically places buy or sell positions through a Polymarket account when a rule is matched. According to the README, the bot targets Polymarket's newer CLOB V2 system and uses the official clob-client-v2 software library to sign and submit orders. Trading rules such as price delta, volatility bands, and timing windows are defined in a TOML configuration file, and wallet and network details go into a separate .env file, including a private key, a proxy wallet address, and a Polygon RPC endpoint URL. The README states that trading requires the account's collateral to be held in pUSD rather than the older USDC.e token, since only pUSD works with CLOB V2. The described execution flow is to load the configuration files, derive or generate Polymarket API credentials, work out the current market based on the configured asset and time period, resolve the relevant market IDs, subscribe to live order book and price data, evaluate the configured entry rules against incoming data, and submit a single position when a rule matches before resetting for the next market cycle. The project can be run in a development mode, with output logged to a file, or compiled to plain JavaScript. The README includes an explicit risk notice stating that the software submits real orders, that prediction markets are volatile, and that the configured strategy can lose money, and it recommends testing with small amounts first. The project is licensed under the MIT License.

Copy-paste prompts

Prompt 1
Walk me through configuring trade.toml's entry rules for this Polymarket bot.
Prompt 2
Explain the difference between CLOB V2 and the older Polymarket trading system this bot uses.
Prompt 3
What wallet and RPC setup do I need before running this bot for the first time?
Prompt 4
Help me understand the risk notice in this bot's README before I fund a wallet.

Frequently asked questions

What is polymarket-arbitrage-bot-v2?

A TypeScript trading bot that automatically places bets on Polymarket's crypto up-or-down prediction markets based on configured rules.

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

Mainly TypeScript. The stack also includes TypeScript, Node.js, Polymarket CLOB V2.

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

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

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

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

Who is polymarket-arbitrage-bot-v2 for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.