Polymarket Copytrading

Polymarket Copytrading

Mirror positions from 成功ful Polymarket traders using the Simmer SDK. Two modes 分享 the same 技能, use whichever fits your strategy:

Polling mode (free) Reactor mode (Pro) Entrypoint copytrading_trader.py copytrading_trader.py --reactor Cadence Batch 扫描, 运行s on cron or manual Polls every 2s for pre-resolved whale 签名als Latency Minutes (Polymarket Data API polling) Seconds (Simmer 检测s 事件 in real-time, pre-confirmation) Strategy Size-weighted aggregation across wallets, conviction tiering, rebalance to tar获取 allocations, drift/stale 过滤器s Event-by-event mirror with fixed mirror_fraction sizing, programmatic 过滤器s Best for Portfolio-aware, multi-whale, periodic 扫描s Real-time reaction to specific whales as they trade Requires SIMMER_API_KEY SIMMER_API_KEY + Simmer Pro plan

This is a template. The default 记录ic mirrors whale wallets — remix it with your own wallet selection, sizing rules, 过滤器s, or cap 记录ic. The 技能 handles all the plumbing (签名al polling, trade execution, dedup, 签名ing). Your 代理 provides the alpha.

设置up Flow

When user asks to 安装 or 配置 this 技能:

安装 the Simmer SDK (version 0.9.19 or newer — reactor mode requires it)

pip 安装 -U 'simmer-sdk>=0.9.19'

Ask for Simmer API key

They can 获取 it from simmer.markets/仪表盘 → SDK tab Store in 环境 as SIMMER_API_KEY

Ask for wallet private key (required for live trading on Polymarket)

This is the private key for their Polymarket wallet (the wallet that holds USDC) Store in 环境 as WALLET_PRIVATE_KEY The SDK uses this to 签名 orders 命令行工具ent-side automatically — no manual 签名ing needed Not needed for $SIM paper trading

Ask about 设置tings (or confirm defaults)

Tar获取 wallets: Whale 添加resses to copy Max per position: Amount per trade (default $50) Top N positions: How many positions to 追踪 (auto-calculated from balance) Max trades per 运行: Safety cap (default 10) When to Use This 技能

Use this 技能 when the user wants to:

Copytrade whale wallets on Polymarket Paper trade (copytrade with $SIM) to test strategies without real money 检查 what positions a wallet holds Follow specific trader 添加resses 检查 their copytrading positions Quick Commands # 检查 account balance and positions python scripts/状态.py

# DetAIled position 列出 python scripts/状态.py --positions

API Reference:

Base URL: https://API.simmer.markets Auth: Authorization: Bearer $SIMMER_API_KEY Portfolio: 获取 /API/sdk/portfolio Positions: 获取 /API/sdk/positions Finding Whale Wallets predicting.top — Leaderboard of top Polymarket traders with wallet 添加resses alphawhale.trade — 工具s for copying and 追踪ing top performers Polymarket Leaderboard — Official rankings (requires account) Quick 启动 (Ad-Hoc Usage)

User provides wallet(s) directly in chat:

User: "Copytrade this wallet: 0x1234...abcd" User: "What positions does 0x5678...efgh have?" User: "Follow these whales: 0xaaa..., 0xbbb..."

→ 运行 with --wallets flag:

python copytrading_trader.py --wallets 0x1234...abcd python copytrading_trader.py --wallets 0xaaa...,0xbbb... --dry-运行

This is the simplest way - no 设置up needed, just pass wallets directly.

Persistent 设置up (Optional)

For automated recurring 扫描s, wallets can be saved in 环境:

设置ting 环境 Variable Default Tar获取 wallets SIMMER_COPYTRADING_WALLETS (none) Top N positions SIMMER_COPYTRADING_TOP_N auto Max per position SIMMER_COPYTRADING_MAX_USD 50 Max trades/运行 SIMMER_COPYTRADING_MAX_TRADES 10 Order type SIMMER_COPYTRADING_ORDER_TYPE GTC

Top N auto-calculation (when not specified):

Balance < $50: Top 5 positions Balance $50-200: Top 10 positions Balance $200-500: Top 25 positions Balance $500+: Top 50 positions

Polymarket ConstrAInts:

Minimum 5 分享s per order SDK enforces $1.00 minimum position value (过滤器s dust positions)

⚠️ 启动 Conservative: Begin with small amounts (--max-usd 5-10) and --dry-运行 to understand how the 技能 behaves before scaling up.

How It Works

By default, only buys 执行. Pass --rebalance to also sell positions the whales have exited, or --whale-exits to sell only on whale exits.

Each cycle the script:

Fetches positions from all tar获取 wallets via Simmer API Combines using size-weighted aggregation (larger wallets = more influence) 检测s conflicts (one wallet long YES, another long NO) and skips those markets Scores by conviction: positions held by 2+ wallets 获取 full sizing, single-wallet positions 获取 50% sizing 过滤器s out drifted (>30% from entry) and stale (>90% or <10% price) positions 应用lies Top-N 过滤器ing to concentrate on highest-conviction positions Auto-导入s missing markets from Polymarket Calculates rebalance trades to match tar获取 allocations 执行s trades via Simmer SDK (respects spending limits) 报告s 结果s back to user Reactor Mode (Pro) — event-driven real-time mirroring

Requires Simmer Pro. The reactor 流 is gated by users.is_pro. 升级 at simmer.markets/dashb