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

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

Links

• Simmer docs
• Polymarket
• Polymarket CLOB API
• Simmer skill building guide