โ† All skills
Tencent SkillHub ยท Developer Tools

Polymarket Copytrading

Mirror positions from top Polymarket traders using Simmer API. Size-weighted aggregation across multiple wallets.

skill openclawclawhub Free
0 Downloads
0 Stars
0 Installs
0 Score
High Signal

Mirror positions from top Polymarket traders using Simmer API. Size-weighted aggregation across multiple wallets.

โฌ‡ 0 downloads โ˜… 0 stars Unverified but indexed

Install for OpenClaw

Quick setup
  1. Download the package from Yavira.
  2. Extract the archive and review SKILL.md first.
  3. Import or place the package into your OpenClaw setup.

Requirements

Target platform
OpenClaw
Install method
Manual import
Extraction
Extract archive
Prerequisites
OpenClaw
Primary doc
SKILL.md

Package facts

Download mode
Yavira redirect
Package format
ZIP package
Source platform
Tencent SkillHub
What's included
SKILL.md, clawhub.json, copytrading_trader.py, scripts/status.py

Validation

  • Use the Yavira download entry.
  • Review SKILL.md after the package is downloaded.
  • Confirm the extracted package contains the expected setup assets.

Install with your agent

Agent handoff

Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.

  1. Download the package from Yavira.
  2. Extract it into a folder your agent can access.
  3. Paste one of the prompts below and point your agent at the extracted folder.
New install

I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.

Upgrade existing

I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.

Trust & source

Release facts

Source
Tencent SkillHub
Verification
Indexed source record
Version
1.7.0

Documentation

ClawHub primary doc Primary doc: SKILL.md 14 sections Open source page

Polymarket Copytrading

Mirror positions from successful Polymarket traders using the Simmer SDK. This is a template. The default logic mirrors whale wallets by size-weighted allocation โ€” remix it with your own wallet selection criteria, position filters, or rebalancing rules. The skill handles all the plumbing (wallet fetching, conflict detection, trade execution). Your agent provides the alpha.

When to Use This Skill

Use this skill when the user wants to: Copytrade whale wallets on Polymarket Paper trade (copytrade with $SIM) to test strategies without real money Check what positions a wallet holds Follow specific trader addresses Check their copytrading positions

Quick Commands

# Check account balance and positions python scripts/status.py # Detailed position list python scripts/status.py --positions API Reference: Base URL: https://api.simmer.markets Auth: Authorization: Bearer $SIMMER_API_KEY Portfolio: GET /api/sdk/portfolio Positions: GET /api/sdk/positions

Finding Whale Wallets

predicting.top โ€” Leaderboard of top Polymarket traders with wallet addresses alphawhale.trade โ€” Tools for copying and tracking top performers Polymarket Leaderboard โ€” Official rankings (requires account)

Quick Start (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..." โ†’ Run with --wallets flag: python copytrading_trader.py --wallets 0x1234...abcd python copytrading_trader.py --wallets 0xaaa...,0xbbb... --dry-run This is the simplest way - no setup needed, just pass wallets directly.

Persistent Setup (Optional)

For automated recurring scans, wallets can be saved in environment: SettingEnvironment VariableDefaultTarget walletsSIMMER_COPYTRADING_WALLETS(none)Top N positionsSIMMER_COPYTRADING_TOP_NautoMax per positionSIMMER_COPYTRADING_MAX_USD50Max trades/runSIMMER_COPYTRADING_MAX_TRADES10 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 shares per order SDK enforces $1.00 minimum position value (filters dust positions) โš ๏ธ Start Conservative: Begin with small amounts (--max-usd 5-10) and --dry-run to understand how the skill behaves before scaling up.

How It Works

By default, only buys execute. 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 target wallets via Simmer API Combines using size-weighted aggregation (larger wallets = more influence) Detects conflicts (one wallet long YES, another long NO) and skips those markets Scores by conviction: positions held by 2+ wallets get full sizing, single-wallet positions get 50% sizing Filters out drifted (>30% from entry) and stale (>90% or <10% price) positions Applies Top-N filtering to concentrate on highest-conviction positions Auto-imports missing markets from Polymarket Calculates rebalance trades to match target allocations Executes trades via Simmer SDK (respects spending limits) Reports results back to user

$SIM Paper Trading

Copytrading supports $SIM mode โ€” mirror whale positions using simulated money on Simmer's LMSR markets. No wallet or USDC required. # Paper trade with $SIM (explicit) python copytrading_trader.py --venue sim --wallets 0x123... --live # Auto-detect: if your account has no linked wallet, $SIM is used automatically python copytrading_trader.py --wallets 0x123... --live In $SIM mode: Trades execute on Simmer's LMSR at real Polymarket prices Each market gets an independent $10K $SIM balance Positions tracked in your Simmer portfolio (source: sdk:copytrading) Whale signals still come from real Polymarket data

Running the Skill

Run a scan (dry run by default โ€” no trades): python copytrading_trader.py Execute real trades: python copytrading_trader.py --live Check positions only: python copytrading_trader.py --positions View current config: python copytrading_trader.py --config Override wallets for one run: python copytrading_trader.py --wallets 0x123...,0x456... Full rebalance mode (includes sells): python copytrading_trader.py --rebalance Sell when whales exit positions: python copytrading_trader.py --whale-exits

Reporting Results

After each run, message the user with: Current configuration (wallets, Top N, max position) Number of wallets fetched and total positions found Markets skipped due to conflicts Trades executed (or skipped with reason) Current portfolio positions Example output to share: ๐Ÿ‹ Copytrading Scan Complete Configuration: โ€ข Following 2 wallets โ€ข Top 10 positions, max $50 each โ€ข Balance: $250.00 USDC Fetched positions: โ€ข 0x1234...abcd: 15 positions โ€ข 0x5678...efgh: 22 positions โ€ข Combined: 28 unique markets โ€ข Conflicts skipped: 2 Top 10 by allocation: 1. "Will BTC hit $100k?" - 18.5% โ†’ BUY YES 2. "Trump pardons X?" - 12.3% โ†’ BUY NO 3. "Fed rate cut Jan?" - 9.8% โ†’ Already held ... Trades executed: 4 buys ($180 total) โ€ข Bought 45 YES shares on "Will BTC hit $100k?" @ $0.82 โ€ข Bought 120 NO shares on "Trump pardons X?" @ $0.15 ... Next scan in 4 hours.

Example Conversations

User: "Copytrade 0x1234...abcd" โ†’ Run: python copytrading_trader.py --wallets 0x1234...abcd โ†’ Report what positions that wallet has and what trades would execute User: "What is 0x5678...efgh holding?" โ†’ Run: python copytrading_trader.py --wallets 0x5678...efgh --dry-run โ†’ Show their positions without trading User: "Follow these wallets: 0xaaa..., 0xbbb..., 0xccc..." โ†’ Run: python copytrading_trader.py --wallets 0xaaa...,0xbbb...,0xccc... โ†’ Aggregate positions across all wallets, report results User: "Copytrade this whale but only top 5 positions" โ†’ Run: python copytrading_trader.py --wallets 0x... --top-n 5 User: "How are my positions doing?" โ†’ Run: python copytrading_trader.py --positions โ†’ Show current Polymarket positions with P&L User: "Show copytrading config" โ†’ Run: python copytrading_trader.py --config โ†’ Display current settings User: "Sell positions that whales have exited" โ†’ Run: python copytrading_trader.py --whale-exits โ†’ Compares your positions to whales, sells any they've closed User: "Do a full rebalance to match the whales" โ†’ Run: python copytrading_trader.py --rebalance โ†’ Includes both buys AND sells to match whale allocations

Finding Good Wallets to Follow

Common approaches: Leaderboard tracking: Check Polymarket leaderboards for consistent performers Whale watchers: Follow known profitable traders on social media Specific strategies: Follow wallets known for weather, politics, or crypto trades The skill works best when: Following 2-5 wallets with overlapping strategies (e.g. all politics-focused, or all crypto-focused) Wallets have similar conviction โ€” mixing very different traders means most positions only appear in one wallet and get reduced sizing (50%) Wallets trade markets available on Polymarket

Conviction Tiers

When following multiple wallets, positions are scored by conviction: High conviction (held by 2+ wallets): full position sizing (max_usd) Low conviction (held by 1 wallet): 50% position sizing High-conviction positions are prioritized in Top N selection. Single-wallet positions still trade, but with reduced size. Using just 1 wallet disables conviction scoring (all positions get full sizing).

Troubleshooting

"Order too small" / "below minimum (5)" Polymarket requires minimum 5 shares per order Increase --max-usd or reduce --top-n to concentrate into fewer positions "No wallets specified" Provide wallet addresses in your message, e.g., "copytrade 0x1234..." Or set SIMMER_COPYTRADING_WALLETS environment variable for recurring scans "Agent has no USDC balance" Need USDC in your Polymarket wallet, or use --venue sim for $SIM paper trading Check wallet is linked at simmer.markets/dashboard "Conflict skipped" Wallets disagree on this market (one long YES, other long NO) Markets with net position < 10% are skipped "All N positions filtered (X conflicts, Y drifted, Z stale)" All whale positions were removed by safety filters Try different target wallets, or reduce to 1 wallet to disable conviction scoring Drift filter skips positions where price moved >30% from whale's entry Stale filter skips near-resolved markets (price >90% or <10%) "Insufficient balance" Not enough USDC for all trades Reduce SIMMER_COPYTRADING_TOP_N or SIMMER_COPYTRADING_MAX_USD "Market could not be imported" Some markets may not be importable (resolved, private, etc.) These are skipped automatically "External wallet requires a pre-signed order" WALLET_PRIVATE_KEY is not set in the environment The SDK signs orders automatically when this env var is present โ€” no manual signing code needed Fix: export WALLET_PRIVATE_KEY=0x<your-polymarket-wallet-private-key> Do NOT attempt to sign orders manually or modify the skill code โ€” the SDK handles it "Balance shows $0 but I have USDC on Polygon" Polymarket uses USDC.e (bridged USDC, contract 0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174) โ€” not native USDC If you bridged USDC to Polygon recently, you likely received native USDC Swap native USDC to USDC.e, then retry

Category context

Code helpers, APIs, CLIs, browser automation, testing, and developer operations.

Source: Tencent SkillHub

Largest current source with strong distribution and engagement signals.

Package contents

Included in package
2 Scripts1 Docs1 Config
  • SKILL.md Primary doc
  • copytrading_trader.py Scripts
  • scripts/status.py Scripts
  • clawhub.json Config