Polymarket Copy-Trading Bot

"CTRL+C, CTRL+TRADE"

Mirror a target trader's Polymarket activity from your own account — TypeScript/Node, poll-based, with size caps and safety rails.

Portfolio, performance, and history — the kind of activity this bot watches and mirrors.

At a glance

| | | |:--|:--| | Watch | A target user (address or username → proxy) on Polymarket | | Poll | On your schedule (COPY_POLL_INTERVAL_MS) | | Copy | Similar orders from your wallet, with multiplier & max size limits |

If you've been looking for polymarket bot, polymarket copy trading, polymarket trading bot typescript, or clob client bot — you're in the right repo.

See it in context

In the Polymarket app you'll see Activity (recent trades and claims) — the stream the bot polls — and Positions (how outcomes show up in your portfolio after execution), plus portfolio stats. The bot automates the follow-the-leader part so you don't have to chase every fill by hand.

What it does

• Watches a target user (address or username → proxy) on Polymarket
• Polls periodically and fetches recent activity
• Copies trades to your account with optional risk controls (multiplier, max order size, trades-only mode)

What it doesn't do

• No profit guarantees. If the target trader jumps off a cliff, the bot will politely ask if you'd like to join them.
• Not a "magic arbitrage printer." It's copy-trading. (If you want true arbitrage, you'll likely need additional routing, pricing, and latency work.)

Clone and run (step by step)

1. Prerequisites

| Requirement | Notes | | --- | --- | | Git | So you can clone the repo (install Git if needed). | | Node.js | v20 or newer — check with node -v. Download from nodejs.org if required. | | npm | Ships with Node; confirm with npm -v. | | Polymarket account | Funded account you control. | | Secrets | Your EOA private key and Polymarket proxy / funder address from the Polymarket UI (never share these). |

2. Clone the repository

Pick a parent folder on your machine, open a terminal there, then:

HTTPS (works everywhere, no SSH setup):

git clone 
cd polymarket-copy-trading-bot

SSH (if you use SSH keys with GitHub):

You should see package.json, src/, and .env.example in the project root.

3. Install dependencies

From the project root (polymarket-copy-trading-bot/):

npm install

This installs everything listed in package.json (including dev tooling used by npm run dev).

4. Create your environment file

The bot reads configuration from a .env file in the project root. Start from the template:

Windows (Command Prompt or PowerShell):

copy .env.example .env

macOS / Linux:

cp .env.example .env

5. Edit .env

Open .env in your editor and set at least:

• COPY_TARGET_USER — Polymarket proxy addres