explaingit

thesammy26/polymarket-arbitrage-bot

Analysis updated 2026-05-18

136TypeScriptAudience · generalComplexity · 4/5Setup · moderate

TLDR

A bot that runs a dump-and-hedge arbitrage strategy on Polymarket's 15-minute Up/Down crypto price markets, aiming to lock in small guaranteed gains.

Mindmap

mindmap
  root((Polymarket arbitrage bot))
    What it does
      Watches Up Down markets
      Buys the dumped side
      Waits for cheap hedge
      Locks in small gain
    Tech stack
      TypeScript
      Node.js
      Polygon blockchain
    Use cases
      Automate dump and hedge
      Simulate before trading
      Redeem winning positions
    Audience
      Prediction market traders
      Automation hobbyists

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

Run an automated dump-and-hedge strategy on Polymarket's 15-minute Up/Down markets.

USE CASE 2

Test the strategy safely in simulation mode before trading real funds.

USE CASE 3

Redeem winning positions automatically on the Polygon blockchain at the end of each round.

What is it built with?

TypeScriptNode.jsPolygon

How does it compare?

thesammy26/polymarket-arbitrage-botamet2901/asterdex-trading-botbonny1220/solana-trading-bot
Stars136136136
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatemoderatemoderate
Complexity4/54/54/5
Audiencegeneralgeneralgeneral

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 wallet private key and testing in simulation mode is recommended before using real funds.

No license information is stated in the README.

In plain English

This bot automates a specific trading strategy on Polymarket's 15-minute Up/Down markets for Bitcoin, Ethereum, Solana, and XRP. On Polymarket, these markets ask whether a crypto asset will be higher or lower than its current price in 15 minutes. Each market has two outcomes, Up and Down, and their prices always add up to $1 at resolution: if you hold both sides you collect exactly $1 regardless of which way the price moves. The strategy the bot uses is called dump-and-hedge. When one side of the market drops sharply in price within the early minutes of a round (the dump), the bot buys it. It then waits for the other side to also become cheap enough that the combined cost of both positions falls below a configurable target, such as $0.95. If you can buy both sides for less than $1 combined, and one of them always pays out $1, the difference is a locked-in gain. If the favorable hedge price does not appear in time, the bot has a stop-loss path that buys the other side anyway at a configured maximum combined cost. The bot polls Polymarket prices once per second by default, automatically finds the currently active market for each asset, and rolls forward to the next period when a round ends. At the end of each round, it can redeem winning positions on the Polygon blockchain where Polymarket operates. Setup requires Node.js version 16 or newer. Configuration is done through a file where you set your wallet private key, which markets to trade, the size of each order, the thresholds that define a dump, and how long to wait before triggering the stop-loss. The bot has a simulation mode that logs trades without placing real orders, which the README recommends using first before switching to production mode. The disclaimer states the software is for educational and research purposes, that prediction markets involve substantial financial risk including possible total loss, and that the authors take no responsibility for outcomes.

Copy-paste prompts

Prompt 1
Explain how the dump-and-hedge strategy in this bot tries to lock in a guaranteed gain.
Prompt 2
How do I configure the dump threshold, hedge target, and stop-loss settings?
Prompt 3
What does simulation mode do differently from production mode in this bot?
Prompt 4
Why do the two outcome prices in a Polymarket Up/Down market always add up to one dollar?

Frequently asked questions

What is polymarket-arbitrage-bot?

A bot that runs a dump-and-hedge arbitrage strategy on Polymarket's 15-minute Up/Down crypto price markets, aiming to lock in small guaranteed gains.

What language is polymarket-arbitrage-bot written in?

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

What license does polymarket-arbitrage-bot use?

No license information is stated in the README.

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

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

Who is polymarket-arbitrage-bot for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.