🤖 Polymarket Bot

Automated multi-account bot for Polymarket — places predictions, farms volume, completes streaks, and maximizes rewards across unlimited accounts with per-account proxy support

╔══════════════════════════════════════════════════════════════════╗
║  Module 1 — Auto Predictor   │  place bets on open markets      ║
║  Module 2 — Volume Farmer    │  hit volume targets every cycle  ║
║  Module 3 — Points Farmer    │  full automation across N accs   ║
║                                                                  ║
║  ✦ Multi-account  ·  Per-account proxies  ·  Async workers     ║
╚══════════════════════════════════════════════════════════════════╝

🚀 Open Polymarket · 🐦 Follow Dev

---

📌 Table of Contents

• How It Works
• Multi-Account & Proxy Support
• Modules
  • Module 1 — Auto Predictor
  • Module 2 — Volume Farmer
  • Module 3 — Points Farmer
• Installation
• Configuration
• Running the Bot
• Running 24/7 on a VPS
• Telegram Commands
• Disclaimer

---

⚡ How It Works

  Polymarket opens new prediction markets
          │
          ▼  (all accounts check simultaneously)
          │
  Per account:
    • Authenticate via Polymarket API key + wallet
    • Route traffic through assigned proxy
    • Fetch open markets ranked by volume/liquidity
    • Place predictions based on configured strategy
    • Track volume targets and streak check-ins
          │
          ▼
  Positions tracked → resolved markets collected  🎯
          │
          ▼
  Telegram summary sent  📱

Every account runs as an independent async worker — one failed proxy or expired session never blocks the others.

---

👥 Multi-Account & Proxy Support

How accounts are configured

All accounts live in accounts.json. Each entry holds its own wallet, API credentials, prediction strategy, and optionally a dedicated proxy.

  accounts.json
  ├── Account #1  →  wallet_1 + apikey_1 + proxy_1 + strategy: majority
  ├── Account #2  →  wallet_2 + apikey_2 + proxy_2 + strategy: contrarian
  ├── Account #3  →  wallet_3 + apikey_3 + (no proxy) + strategy: random
  └── ...unlimited accounts
          │
          ▼
  Bot spawns one async worker per account
          │
          ▼
  Workers run in parallel up to MAX_PARALLEL
  Remaining accounts queue and start as slots free

accounts.json structure:

[
  {
    "id": "account_1",
    "label": "Main",
    "wallet_address": "0xYourWallet1",
    "private_key": "0xYourPrivateKey1",
    "polymarket_api_key": "your_api_key_1",
    "polymarket_api_secret": "your_api_secret_1",
    "polymarket_passphrase": "your_passphrase_1",
    "referral_code": "YOUR_REF",
    "strategy": "majority",
    "proxy": "http://user:pass@host:port"
  },
  {
    "id": "account_2",
    "label": "Secondary",
    "wallet_address": "0xYourWallet2",
    "private_key": "0xYourPrivateKey2",
    "polymarket_api_key": "your_api_key_2",
    "polymarket_api_secret": "your_api_secret_2",
    "polymarket_passphrase": "your_passphrase_2",
    "referral_code": "YOUR_REF",
    "strategy": "contrarian",
    "proxy": "socks5://user:pass@host:port"
  },
  {
    "id": "account_3",
    "label": "No proxy",
    "wallet_address": "0xYourWallet3",
    "private_key": "0xYourPrivateKey3",
    "polymarket_api_key": "your_api_key_3",
    "polymarket_api_secret": "your_api_secret_3",
    "polymarket_passphrase": "your_passphrase_3",
    "referral_code": "YOUR_REF",
    "strategy": "random",
    "proxy": ""
  }
]

How to get Polymarket API credentials

1. Go to polymarket.com and connect your wallet
2. Navigate to Profile → Settings → API Keys
3. Click Create API Key
4. Save the API Key, Secret, and Passphrase — they are shown only once
5. Add them to the corresponding account entry in accounts.json

⚠️ Each Polymarket account needs its own set of API credentials. The same wallet cannot have multiple active API keys simultaneously.

Proxy formats supported

| Format | Example | |--------|---------| | HTTP | http://user:pass@host:port | | HTTPS | https://user:pass@host:port | | SOCKS5 | socks5://user:pass@host:port | | No auth | http://host:port | | None | leave "proxy": "" |

Concurrency & safety settings

MAX_PARALLEL=5              # Max accounts running at the same time
ACCOUNT_DELAY=15            # Seconds between launching each worker
JITTER=true                 # Random ±10s delay per action (human-like)
PROXY_TEST_ON_START=true    # Verify each proxy before farming begins
ROTATE_USER_AGENT=true      # Unique user-agent per account

💡 Tip: Running many accounts from one IP risks detection. Assign a dedicated proxy to every account. Enable PROXY_TEST_ON_START=true — bad proxies are flagged before the cycle starts, not mid-run.

---

📐 Modules

🔮 Module 1 — Auto Predictor

The bot fetches open Polymarket markets, ranks them by liquidity and volume, and places limit or market orders on behalf of each account according to its strategy.

  Fetch open markets via Polymarket API  (per account)
              │
              ▼
  Filter:
    • Min liquidity > PREDICT_MIN_LIQUIDITY
    • Not already holding a position
    • Within allowed categories
    • Closing date > MIN_HOURS_TO_CLOSE
              │
              ▼
  Apply strategy:
    • majority    → buy the leading side (YES if >50% probability)
    • contrarian  → buy the trailing side
    • random      → random YES / NO
    • custom      → filter by keyword/category, buy a fixed side
              │
              ▼
  Place LIMIT order at current best price  ✅
  (falls back to MARKET if limit not filled within timeout)
              │
              ▼
  Position tracked until resolution  →  collect USDC payout  💵

Prediction strategies:

| Strategy | Logic | Best for | |----------|-------|----------| | majority | Buy leading side (highest probability) | Safer volume farming | | contrarian | Buy trailing side (lower probability, higher odds) | Higher variance, more upside | | random | Random YES / NO per market | Maximum market coverage | | custom | Filter by category + keyword | Targeted category farming |

Config block:

MODULE=predictor
PREDICT_STRATEGY=majority
PREDICT_AMOUNT=1                   # USDC per prediction
PREDICT_MAX_PER_CYCLE=10           # Max new positions per account per cycle
PREDICT_CATEGORIES=politics,crypto # Only enter these categories (blank = all)
PREDICT_MIN_LIQUIDITY=1000         # Skip markets with less than $N liquidity
PREDICT_MIN_HOURS_TO_CLOSE=6       # Skip markets closing in less than N hours
PREDICT_ORDER_TYPE=LIMIT           # LIMIT or MARKET
PREDICT_LIMIT_TIMEOUT=60           # Seconds to wait for limit fill before cancel
PREDICT_INTERVAL=3600              # Check for new markets every N seconds

💡 Tip: Keep PREDICT_AMOUNT small (1–5 USDC) — the goal is volume coverage and streak maintenance, not speculation. Use PREDICT_MIN_LIQUIDITY to avoid illiquid markets where orders don't fill.

---

📊 Module 2 — Volume Farmer

Tracks each account's trading volume and ensures weekly/monthly volume targets are hit — which unlock higher reward tiers on Polymarket.

  Check current volume for account  (period: weekly / monthly)
              │
              ▼
  Volume below target?
    • YES → calculate how many more trades needed
            → spread trades across remaining days
            → execute via Auto Predictor  (Module 1)
    • NO  → sleep until next period
              │
              ▼
  Volume target reached  →  tier reward unlocked  🏆
              │
              ▼
  Telegram alert: tier reached + USDC reward if any

Volume tiers (approximate — check Polymarket for current values):

| Tier | Weekly Volume | Reward | |------|--------------|--------| | Bronze | $100+ | Base rewards | | Silver | $500+ | 1.25× multiplier | | Gold | $2,000+ | 1.5× multiplier | | Platinum | $10,000+ | 2× multiplier |

Config block:

MODULE=volume
VOLUME_TARGET_WEEKLY=500           # USDC weekly volume target per account
VOLUME_TARGET_MONTHLY=2000         # USDC monthly volume target per account
VOLUME_SPREAD_EVENLY=true          # Spread trades over remaining days in period
VOLUME_CHECK_INTERVAL=3600         # Check volume progress every N seconds
VOLUME_ALERT_AT_PERCENT=80         # Telegram alert when N% of target reached

💡 Tip: Enable VOLUME_SPREAD_EVENLY=true — spreading trades prevents a burst of activity on the last day of the period, which looks unnatural and may trigger review.

---

🌾 Module 3 — Points Farmer

Combines both modules into one fully automated loop. Each account runs its own independent cycle — predictions, volume tracking, and streak check-ins all managed in parallel.

  All account workers start  (staggered by ACCOUNT_DELAY)
          │
          ▼  each worker independently:
          │
  Place predictions on open markets  (Module 1)
          │
          ▼
  Track and top up volume target  (Module 2)
          │
          ▼
  Wait CYCLE_INTERVAL