whatisgithub

What is polymarket-trading-bot?

blackcandlelab/polymarket-trading-bot — explained in plain English

Analysis updated 2026-05-18

301JavaScriptAudience · developerComplexity · 3/5Setup · moderate

In one sentence

A Node.js trading bot for Polymarket's BTC Up/Down markets that runs arbitrage and copy-trading strategies with configurable risk limits.

Mindmap

mindmap
  root((Polymarket Bot))
    Strategies
      Arbitrage mode
      Copy-trading mode
    Market
      BTC Up/Down 5min
      Polygon blockchain
    Risk Controls
      Max spend per market
      Max hourly loss
      Inventory limits
    Requirements
      Node.js 18+
      Funded Polygon wallet
      API credentials

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 trade Yes/No spread arbitrage on Polymarket's 5-minute BTC markets.

USE CASE 2

Mirror a chosen wallet's trades through copy-trading mode.

USE CASE 3

Set spend, loss, and inventory limits to control risk on automated trades.

What is it built with?

Node.jsJavaScriptPolygon

How does it compare?

blackcandlelab/polymarket-trading-botxbuilderlab/cheat-on-moneynodejs/github-bot
Stars301302299
LanguageJavaScriptJavaScriptJavaScript
Last pushed2026-06-29
MaintenanceActive
Setup difficultymoderatehard
Complexity3/54/5
Audiencedevelopergeneraldeveloper

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

How do you get it running?

Difficulty · moderate Time to first run · 1h+

Requires a funded Polymarket wallet, API credentials, and ideally a private Polygon RPC node.

So what is it?

This is a Node.js trading bot for Polymarket, a prediction market platform where people bet on short-term outcomes. The bot focuses on BTC Up/Down markets, which are short 5-minute windows where you bet on whether Bitcoin's price will be higher or lower at the close. All trades run on the Polygon blockchain through Polymarket's order book. The bot has two main operating modes. Arbitrage mode watches the order book via a live data feed and places trades when the combined price of the Yes and No sides of a market falls below $1.00, which creates a theoretical profit opportunity (since one side must pay out $1). Copy-trading mode watches a target wallet address and mirrors its buy orders, following the signal of a trader you believe has an edge. The README includes a candid analysis of how the competitive landscape for simple arbitrage has changed. By 2026, the document argues, the classic Yes+No spread play is mostly captured by bots operating in under 100 milliseconds on dedicated infrastructure. The README frames this bot as part of a multi-strategy approach: it covers the 5-minute momentum and latency strategy, partial market-making through dual-sided order ladders, and copy-trading as a social signal path. Features like AI-powered news signals and cross-market correlation plays are described as extension points not included in this codebase. Risk management is built in. You configure maximum spend per market, maximum hourly loss before the bot stops, inventory imbalance limits, and a cutoff window before market resolution where the bot stops placing new orders. These controls are set through a configuration file. Requirements include Node.js 18 or higher, a Polymarket account with a funded wallet on Polygon, and API credentials from the platform. The README recommends using a private Polygon RPC node for speed rather than a public one. All configuration happens through environment variables. The project includes a disclaimer that it is educational and operational tooling, not financial advice, and that past backtested statistics do not guarantee future results.

Copy-paste prompts

Prompt 1
Help me set up this Polymarket bot's environment variables for arbitrage mode.
Prompt 2
Explain how the Yes+No spread arbitrage strategy in this bot works and why it pays off below $1.00.
Prompt 3
Walk me through configuring risk limits like max hourly loss and inventory imbalance.
Prompt 4
What's the difference between this bot's arbitrage mode and copy-trading mode?

Frequently asked questions

What is polymarket-trading-bot?

A Node.js trading bot for Polymarket's BTC Up/Down markets that runs arbitrage and copy-trading strategies with configurable risk limits.

What language is polymarket-trading-bot written in?

Mainly JavaScript. The stack also includes Node.js, JavaScript, Polygon.

How hard is polymarket-trading-bot to set up?

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

Who is polymarket-trading-bot for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.