Polymarket Whale Copytrader 🐋

Monitors a configurable list of high-performing Polymarket wallets and mirrors their recent trades — automatically.

This is a template. The default signal is on-chain trade activity from configured whale wallets. Remix it by swapping in your own wallet list, adding a Polymarket leaderboard scraper to auto-discover top traders, or layering a volume filter to only copy their highest-conviction trades. The skill handles all the plumbing (trade detection, market resolution, deduplication, safeguards). You provide the wallets.

Strategy

Every 15 minutes, scan configured whale wallets via the Polymarket CLOB API
Filter trades to the last lookback_minutes window (default: 30 min)
Skip trades below min_whale_trade_usd (default: $500) — only copy high-conviction moves
Resolve the Polymarket token ID to a Simmer market (searches by question, imports if needed)
Skip markets you already hold — no doubling up
Check Simmer context: skip on flip-flop warnings, high slippage, resolved markets
Mirror the trade with your configured position size
Tag all trades for per-skill volume attribution on Simmer

Requirements

SIMMER_API_KEY — your Simmer agent API key
simmer-sdk — installed via pip
No additional API keys needed (uses Polymarket's public CLOB + Gamma APIs)

Configuration

| Variable | Default | Description | |----------|---------|-------------| | SIMMER_API_KEY | required | Your Simmer API key | | TRADING_VENUE | polymarket | sim, polymarket, or kalshi | | SIMMER_COPYTRADE_WALLETS | built-in list | Comma-separated wallet addresses to track | | SIMMER_COPYTRADE_MAX_POSITION | 10.0 | Max USD per copied trade | | SIMMER_COPYTRADE_MAX_TRADES | 5 | Max trades per cron run | | SIMMER_COPYTRADE_LOOKBACK_MINS | 30 | Minutes of trade history to scan | | SIMMER_COPYTRADE_MIN_TRADE | 500 | Min USD value of whale trade to copy | | SIMMER_COPYTRADE_SIZING_PCT | 0.05 | Portfolio % for smart sizing | | SIMMER_COPYTRADE_SKIP_PAID | true | Skip markets with 10% taker fee |

Set via CLI:

python copytrading.py --set max_position_usd=25
python copytrading.py --set lookback_minutes=60

Usage

# Install
pip install simmer-sdk

# See which wallets you're tracking + their stats
python copytrading.py --whales

# Dry run (default — no real trades)
python copytrading.py

# Live trading
python copytrading.py --live

# Portfolio-based position sizing (5% of balance per trade)
python copytrading.py --live --smart-sizing

# Show open positions
python copytrading.py --positions

# Show config
python copytrading.py --config

Customizing Whale Wallets

The default list includes known high-volume Polymarket traders. To use your own:

export SIMMER_COPYTRADE_WALLETS="0xABC...,0xDEF...,0x123..."

Finding good wallets:

Polymarket leaderboard — filter by profit, not volume
Polymarket CLOB API — query top traders programmatically
Follow wallets that show consistent profit over 3+ months, not just one big win

What makes a good whale to copy:

High win rate (>55%) across diverse markets, not just one category
Trades early — not right before resolution
Position sizes suggest conviction, not randomness

Remix Ideas

Auto-discover top wallets:

Query https://gamma-api.polymarket.com/leaderboard to dynamically update WHALE_WALLETS
Rank by 30-day P&L, take the top 10, refresh weekly

Filter by category:

Only copy trades in crypto, politics, or sports markets
Add a keyword filter to fetch_whale_recent_trades()

Conviction sizing:

Scale your copy size proportionally to the whale's position size
If whale bets $5k, bet 1% of that ($50)

Sentiment confirmation:

Only copy a whale trade if 2+ whales made the same move in the same window
Reduces noise from individual whale mistakes

Exit mirroring:

Detect when a whale exits a position and mirror the sell
Currently the skill copies entries only; exits rely on Simmer's auto stop-loss (50%)

Safety Rails

Flip-flop detection — skips markets where you've been reversing
Slippage check — skips illiquid markets (>15% estimated slippage)
Deduplication — never copies the same market twice in one run
Position check — skips markets you already hold
Paid market filter — optionally skips markets with 10% taker fee
Simmer default limits — $100/trade, $500/day, 50 trades/day (configurable via dashboard)
Dry run default — real trades require explicit --live

Polymarket Copytrading