COPYBOT

This repo contains two separate (but complementary) tools:

1. CopyBot (Python): a Polymarket prediction-market copier.
2. Web Dashboard (Next.js): a read-only tracker/finder UI for scanning wallets and saving watchlists.

They help each other:

• Use the Dashboard to find profitable/consistent wallets.
• Feed the best wallet into CopyBot as TARGET_WALLET.

---

1) CopyBot (Python) — BUY-only prediction copier

What it does

• Watches a master wallet’s activity.
• Mirrors BUY-only (prediction-market mode) from your wallet.
• Safety: per-trade caps + optional budget scaling + rate limit between trades + dedupe state.
• Colored console logs:
  • Amounts + total spent: green
  • Prices: yellow
  • Outcome: up/yes green, down/no red

Quick start (dry run first)

cd <path-to-repo>

$env:TARGET_WALLET="0xMASTER_WALLET_TO_FOLLOW"
$env:POLY_PRIVATE_KEY="0xYOUR_PRIVATE_KEY"   # keep this secret
$env:DRY_RUN="1"                              # 1 = simulate, 0 = live

python .\bots\copybot.py

Go live (place real orders)

$env:DRY_RUN="0"
python .\bots\copybot.py

Full command presets

See docs/BOT_COMMANDS.md.

Monitor-only mode

python .\bots\copybot.py --monitor-only --target-wallet 0xMASTER_WALLET_TO_FOLLOW

More details are in docs/RUNDOWN.md.

---

2) Web Dashboard (Next.js) — tracker/finder UI (read-only)

What it does

• Lets you paste a wallet address, view activity and wallet metrics, and maintain a watchlist.
• Does not trade. It only reads Polymarket data.
• Uses Polymarket Data API endpoints via Next.js API routes.

Run locally

cd <path-to-repo>\apps\dashboard
npm install
npm run dev

Open:

• http://localhost:3000

More details: apps/dashboard/README.md.

---

Repo docs

• docs/BOT_COMMANDS.md: copy/paste PowerShell commands + presets for CopyBot.
• docs/RUNDOWN.md: full technical rundown of bot + dashboard.
• apps/dashboard/README.md: how to run the tracker UI.