Polymarket Copy Trading Bot

A copy trading bot for Polymarket that mirrors trades from target wallets in real time. Built with TypeScript: WebSocket or API polling for trade detection, Polymarket CLOB for execution, with risk controls and optional auto-redemption.

Table of contents

• Overview
• Prerequisites
• Quick start: run the bot in 5 steps
• How to run the bot
• How to set environment variables (.env)
• Target wallets (config.json)
• Environment variable reference
• Scripts reference
• Project structure
• Security & disclaimer

Overview

• Real-time trade mirroring – Monitors target wallets via WebSocket or API and copies their trades.
• Configurable sizing – Per-wallet order size in src/config/config.json (USDC or token amount).
• Risk management – Buy threshold, stop-loss (SELL_PRICE), take-profit (PROFIT_SELL_THRESHOLD).
• Auto-redemption – Optional scheduled redemption of resolved positions.
• Telegram – Optional notifications when target wallets trade.

Prerequisites

Before you start, ensure you have:

Quick start: run the bot in 5 steps

1. Clone and install

   cd Polymarket-Copytrading-Bot
   npm install

2. Create your .env file

   cp .env.example .env

3. Edit .env – set these required values

   • PRIVATE_KEY – Your wallet private key (e.g. from MetaMask: Account → three dots → Account details → Export Private Key). Must start with 0x.
   • PROXY_WALLET_ADDRESS – Your Polymarket proxy wallet address (see Finding your proxy wallet).
   • DRY_RUN=false – So the bot places real orders (set true to only log, no orders).

4. Edit src/config/config.json – add target wallets

   • Add the Polymarket wallet addresses you want to copy. The number is the order size (tokens or USDC depending on ORDER_SIZE_IN_TOKENS).

   {
       "0xAddressOfTrader1": 1,
       "0xAddressOfTrader2": 5
   }

5. Run the bot

   npm start

   Or use API polling instead: npm run copytrade.

On first run, the bot will create src/data/credential.json (Polymarket API credentials). Keep that file and .env secret and never commit them.

How to run the bot

Two ways to run copy trading

Both use the same .env and src/config/config.json. Use one at a time.

Step-by-step: first run

1. Install dependencies (once)

   npm install

2. Copy and fill .env

   cp .env.example .env

   Open .env and set at least:

   • PRIVATE_KEY=0x... (your EOA private key)
   • PROXY_WALLET_ADDRESS=0x... (your Polymarket proxy)
   • DRY_RUN=false (to allow real buy/sell)

3. Add target wallets in src/config/config.json
   Format: "0xWalletAddress": number. The number is the size per copy-trade (see Target wallets).

4. Optional: test without placing orders
   Set DRY_RUN=true in .env, then run the bot. It will log what it would do but not send orders.

5. Start the bot

   npm start

   or

   npm run copytrade

6. First-run behaviour

   • If src/data/credential.json is missing, the bot creates it (Polymarket API key).
   • It may prompt or run allowance/balance checks. Ensure your proxy wallet has USDC and approvals on Polygon.

Other useful commands

• Check wallet and balance (no trading):

  npm run balance

• Monitor one wallet (log trades only, no copying):

  npm run monitor

• Auto-redeem resolved positions:

  npm run auto-redeem

• Clear copy-trade history (e.g. to reprocess old trades):

  npm run clear-history

How to set environment variables (.env)

The bot reads configuration from a .env file in the project root. Never commit .env or share it.

Creating .env

cp .env.example .env

Then open .env in a text editor and replace the placeholder values.

Required variables (must set)

Finding your proxy wallet

• Option A: In the Polymarket app or website, go to your profile / account or deposit/withdraw. The proxy address is often shown there (it’s the “smart wallet” or “proxy” address).
• Option B: Set only PRIVATE_KEY in .env, run npm run balance. The script can derive and print the proxy address for your EOA; then copy it into PROXY_WALLET_ADDRESS in .env.

Enabling real buy/sell orders

Set DRY_RUN=false in .env when you want the bot to actually trade.

Copy-trading switch

Chain and RPC

You can leave RPC unset; the bot has default endpoints (rate limits may apply).

Trading behaviour

Risk and thresholds

Slippage and retries

API polling (for npm run copytrade)

Optional: Telegram

When both are set, the bot can send a notification when a target wallet trades.

Optional: auto-redeem and CLOB

Debug

Minimal .env example (real orders)

PRIVATE_KEY=0xYourPrivateKeyHere
PROXY_WALLET_ADDRESS=0xYourPolymarketProxyAddress
DRY_RUN=false
ENABLE_COPY_TRADING=true

Everything else can be omitted to use defaults, or copy from .env.example and adjust.

Target wallets (config.json)

Target wallets are not in .env. They are configured in src/config/config.json.

Format

{
    "0xWalletAddressToCopy1": 1,
    "0xWalletAddressToCopy2": 5
}

• Key – Polymarket wallet address (proxy or EOA) of the trader you want to copy.
• Value – Number: order size per copy-trade.
  • If ORDER_SIZE_IN_TOKENS=true (default): size = number of tokens to buy/sell.
  • If ORDER_SIZE_IN_TOKENS=false: size = USDC amount (or balance-based depending on config).

Where to get target addresses

Use the Polymarket profile or activity URL of the trader; the address shown there (often the proxy) is what you put in config.json. The bot matches trades by this address.

Example

Copy two traders: one with 1 token per trade, one with 5 tokens per trade:

{
    "0xaac8e98e05cf679616dec6c47755748b4cb0bff1": 1,
    "0x4c353dd347c2e7d8bcdc5cd6ee569de7baf23e2f": 5
}

Save the file; the bot reads it on startup. No need to restart for every edit if you only change config occasionally (restart after editing for changes to apply).

Environment variable reference

Quick reference for all supported variables. See How to set environment variables for details.

Scripts reference

Project structure

polymarket-copytrading-bot-ts/
├── .env                    # Your secrets (create from .env.example)
├── .env.example            # Template for .env
├── package.json
├── src/
│   ├── index.ts            # WebSocket copy-trade entry (npm start)
│   ├── copytrade.ts    # API copy-trade entry (npm run copytrade)
│   ├── auto-redeem-copytrade.ts
│   ├── config/
│   │   ├── env.ts          # Reads .env
│   │   └── config.json     # Target wallets + sizes
│   ├── copy-trade/
│   │   ├── core.ts         # processTrade() – shared copy logic
│   │   └── risk-manager.ts
│   ├── data/
│   │   ├── credential.json # API credentials (auto-created)
│   │   └── token-holding.json
│   ├── providers/
│   │   ├── clobclient.ts   # CLOB (uses PRIVATE_KEY + PROXY_WALLET_ADDRESS)
│   │   └── wssProvider.ts
│   ├── security/
│   │   ├── createCredential.ts
│   │   └── allowance.ts
│   ├── other/
│   │   ├── redeem.ts
│   │   ├── monitor-wallet.ts
│   │   └── wallet-balance.ts
│   └── utils/
│       ├── proxyWallet.ts
│       ├── balance.ts
│       └── redeem.ts
└── README.md