explaingit

texsellix/polymarket-trading-bot

Analysis updated 2026-06-24

244TypeScriptAudience · developerComplexity · 4/5LicenseSetup · moderate

TLDR

Command-line and SDK for trading on Polymarket: direct orders, copy-trading another wallet, and built-in arbitrage, mean-reversion, momentum, and endgame strategies.

Mindmap

mindmap
  root((polybot))
    Inputs
      Polygon private key
      Target wallet
      Strategy flags
    Outputs
      Polymarket orders
      Paper fills
      Risk reports
    Strategies
      Arbitrage
      Mean reversion
      Momentum
      Endgame
    Tech Stack
      TypeScript
      Node 20
      Polygon
Click or tap to explore — scroll the page freely

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

Mirror another Polymarket trader's positions at a configurable fraction

USE CASE 2

Run arbitrage on binary markets where YES plus NO is under one

USE CASE 3

Embed Polymarket order placement into a Claude or GPT agent via the SDK

What is it built with?

TypeScriptNode.jsPolygonEIP-712

How does it compare?

texsellix/polymarket-trading-botseochecks-ai/sloplessgermondai/trawl
Stars244255218
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderateeasymoderate
Complexity4/52/53/5
Audiencedeveloperwriterops devops

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Needs Node 20+ and a Polygon wallet funded with USDC.e, --live flag is required to leave paper mode.

MIT license, allowing free use, modification, and redistribution with attribution.

In plain English

Polybot is a command-line tool for trading on Polymarket, the prediction market platform built on Polygon. The whole product is a terminal app: there is no dashboard, no signup, no .env file to set up. You install it globally with npm, it prompts once for your Polygon wallet private key, and then you can scan markets, place orders, or mirror other traders with one command. Paper trading is on by default, and you have to add a --live flag for any command to commit real USDC. The headline features are direct trading, copy trading, and autonomous strategies. With polybot trade you place a single buy or sell order on a market. With polybot copy you point at another wallet address and Polybot watches that wallet on the Polymarket Data API, mirroring every entry and exit at a fraction of the original size that you specify. With polybot auto you turn on one or more built-in strategies: arbitrage on binary markets where YES plus NO is less than one, mean reversion that fades aggressive moves, momentum that rides trends with trailing stops, and an endgame strategy that buys deep in-the-money probability near expiry. Every order, whether manual, copied, or strategy-driven, goes through a risk engine that enforces position caps, daily loss limits, slippage guards, and market allow or block lists. The README says paper mode is enforced at the engine level so strategies cannot bypass it, and the same is true for any AI agent driving the SDK. There is a companion package called @polybot/sdk that exposes the same functionality as TypeScript calls, intended to be embedded in backends, CI jobs, or LLM agents. The README pitches it specifically as the cleanest Polymarket layer for Claude, GPT, Gemini, the Vercel AI SDK, or MCP setups, since market discovery, quotes, and order placement are each a single function call. There is no browser automation involved, it talks directly to the Polymarket REST API and signs orders with EIP-712. On security, wallet keys are encrypted before leaving the machine using authenticated symmetric encryption with a per-user data key. Plaintext keys live in memory only during signing and are wiped after. The local cache stores only the address and an 8-byte fingerprint. Logging redacts secrets automatically. Requirements are minimal: Node 20 or newer and a Polygon wallet with USDC.e for live trading. The license is MIT.

Copy-paste prompts

Prompt 1
Walk me through installing polybot globally and placing a paper trade on a binary Polymarket
Prompt 2
Show how polybot copy mirrors a target wallet and where the size fraction is set
Prompt 3
Wire @polybot/sdk into an MCP server so an LLM agent can quote and place orders
Prompt 4
Explain the risk engine guards that prevent a strategy from bypassing paper mode

Frequently asked questions

What is polymarket-trading-bot?

Command-line and SDK for trading on Polymarket: direct orders, copy-trading another wallet, and built-in arbitrage, mean-reversion, momentum, and endgame strategies.

What language is polymarket-trading-bot written in?

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

What license does polymarket-trading-bot use?

MIT license, allowing free use, modification, and redistribution with attribution.

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

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is polymarket-trading-bot for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.