polymarket-copytrading
Mirror positions from top Polymarket traders. Polling mode (free) for portfolio-style copying, Reactor mode (Pro) for event-driven real-time mirroring via Simmer's on-chain signal infrastructure.
Rank
62
Safety
84
Downloads
4.7k
Updated
Oct 9, 2026
Version
1.12.4
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 4.7K downloads reported by the source. Last updated 10/9/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 9, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 9, 2026
- Adoption signal
- 4.7K downloadsadoption · observed Oct 9, 2026
- Latest release
- 1.12.4release · observed Sep 23, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s17eez0vajry6hjb97y9mbtv2s85wekv:polymarket-copytrading- Install using `clawhub skill install s17eez0vajry6hjb97y9mbtv2s85wekv:polymarket-copytrading` in an isolated environment before connecting it to live workloads.
- No published capability contract is available yet, so validate auth and request/response behavior manually.
- Review the upstream CLAWHUB listing at https://clawhub.ai/simmer/polymarket-copytrading before using production credentials.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-simmer-polymarket-copytrading/snapshot"
Documentation
CLAWHUB
152,865 characters of source documentation, loaded on request.
Extracted files
5 files captured from the source.
SKILL.md
--- name: polymarket-copytrading description: Mirror positions from top Polymarket traders. Polling mode (free) for portfolio-style copying, Reactor mode (Pro) for event-driven real-time mirroring via Simmer's on-chain signal infrastructure. metadata: author: Simmer (@simmer_markets) version: "1.12.4" displayName: Polymarket Copytrading difficulty: beginner --- # Polymarket Copytrading Mirror positions from successful Polymarket traders using the Simmer SDK. Two modes share the same skill, use whichever fits your strategy. > 🚨 **Framework, not a production trading system.** Read [DISCLAIMER.md](./DISCLAIMER.md) before connecting to a wallet with real funds. Per-position cap defaults to $50; per-run cap defaults to 10 trades. Use `$SIM` paper-mode to validate any new whale selection before scaling to real USDC. > **This is a template.** The default logic mirrors whale wallets — remix it with your own wallet selection, sizing rules, filters, or cap logic. The skill handles all the plumbing (signal polling, trade execution, dedup, signing). Your agent provides the alpha. | | **Polling mode** (free) | **Reactor mode** (Pro) | |---|---|---| | Entrypoint | `copytrading_trader.py` | `copytrading_trader.py --reactor` | | Cadence | Batch scan, runs on cron or manual | Polls every 2s for pre-resolved whale signals | | Latency | Minutes (Polymarket Data API polling) | Seconds (Simmer detects events in real-time, pre-confirmation) | | Strategy | Size-weighted aggregation across wallets, conviction tiering, rebalance to target allocations, drift/stale filters | Event-by-event mirror with fixed `mirror_fraction` sizing, programmatic filters | | Best for | Portfolio-aware, multi-whale, periodic scans | Real-time reaction to specific whales as they trade | | Requires | `SIMMER_API_KEY` | `SIMMER_API_KEY` + Simmer Pro plan | ## Setup Flow When user asks to install or configure this skill: 1. **Install the Simmer SDK** (version 0.9.19 or newer — reactor mode requires it) ```bash pip install -U 'simmer-sdk>=0.9.19' ``` 2. **Ask for Simmer API key** - They can get it from simmer.markets/dashboard → SDK tab - Store in environment as `SIMMER_API_KEY` 3. **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 environment as `WALLET_PRIVATE_KEY` - The SDK uses this to sign orders client-side automatically — no manual signing needed - Not needed for $SIM paper trading 4. **Ask about settings** (or confirm defaults) - Target wallets: Whale addresses to copy - Max per position: Amount per trade (default $50) - Top N positions: How many positions to track (auto-calculated from balance) - Max trades per run: Safety cap (default 10) ## 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
_meta.json
{
"ownerId": "kn7axnp7bzqsf5fkx0z8px7han7zyq1x",
"slug": "polymarket-copytrading",
"version": "1.12.4",
"publishedAt": 1790133045894
}DISCLAIMER.md
# Disclaimer This skill is a **framework**, not a production trading system. Read this in full before connecting it to a wallet with real funds. ## No financial advice Nothing in this skill constitutes financial, investment, or trading advice. The default strategy implemented here is a starting point, not a tested edge. Suitability for any account size or risk tolerance is your responsibility to assess. ## Default parameters are not validated Default parameters are calibrated for testing the plumbing, not for live profit. They have not been validated to produce positive returns under current market conditions. Run paper mode for an extended period before scaling beyond default position sizes. ## Automated trading carries irreversible risk When this skill runs with `--live`, it places real on-chain orders. On-chain trades cannot be recalled. Strategy errors, signal lag, market regime shifts, and operator misconfiguration can produce losses exceeding any specific position size. ## Risk monitoring may not apply to all market types Stop-loss and take-profit monitors run on a fixed schedule. Markets that resolve faster than the monitor cycle cannot be exited automatically. Position sizing is the only risk control on these markets — set it conservatively. ## Use of this skill is at your own risk By installing and running this skill you agree that the authors are not liable for any losses, direct or indirect, that arise from its use. This applies regardless of skill provenance — official Simmer skills, community skills, and skills imported from external repositories all carry this same disclaimer. ## Where to learn more before going live - The skill's own `SKILL.md` documents the strategy and parameters - Your trading venue's documentation covers fee structure, order types, and resolution rules - Simmer SDK documentation covers paper mode, dry-run flags, and position monitoring
skill-card.md
## Description: Mirror positions from top Polymarket traders. Polling mode (free) for portfolio-style copying, Reactor mode (Pro) for event-driven real-time mirroring via Simmer's on-chain signal infrastructure. This skill is ready for commercial/non-commercial use. ## Publisher: [simmer](https://clawhub.ai/user/simmer) ### License/Terms of Use: MIT-0 ## Use Case: External users and agents use this skill to inspect Polymarket trader positions, configure whale wallets to follow, run dry-run or paper copytrading checks, and optionally execute live mirrored trades with configured caps. ### Deployment Geography for Use: Global ## Known Risks and Mitigations: Risk: The skill can place real-money trades when live mode and credentials are configured. Mitigation: Use dry-run or $SIM paper mode first, keep per-position and per-run caps small, and review proposed trades before scaling to real USDC. Risk: Automatic venue routing can convert above-cap simulated Reactor signals to Polymarket orders. Mitigation: Set COPYTRADING_FORCE_SIMMER_VENUE=true when simulated-only execution is required. Risk: Unattended live runs can continue acting on new whale signals without active review. Mitigation: Avoid cron, loop, or nohup live execution until behavior, wallet setup, and caps have been reviewed. Risk: External-wallet trading depends on WALLET_PRIVATE_KEY, which is highly sensitive. Mitigation: Store the private key only in a protected environment and avoid exposing it in logs, prompts, shell history, or shared configuration. Risk: Sell behavior and rebalance options can close positions as well as buy mirrored positions. Mitigation: Review sell-related flags and defaults before live use, and confirm whether buy-only, whale-exit, or full-rebalance behavior is intended. ## Reference(s): - [ClawHub skill page](https://clawhub.ai/simmer/skills/polymarket-copytrading) - [Simmer API](https://api.simmer.markets) - [Simmer dashboard](https://simmer.markets/dashboard) - [Simmer V2 migration guide](https://docs.simmer.markets/v2-migration) - [predicting.top](https://predicting.top) - [alphawhale.trade](https://alphawhale.trade) ## Skill Output: **Output Type(s):** [text, markdown, shell commands, configuration, guidance] **Output Format:** [Markdown and terminal-oriented status summaries with inline shell commands and configuration values] **Output Parameters:** [1D] **Other Properties Related to Output:** [May run dry-run, paper, or live trading commands depending on user configuration; live trading requires Simmer credentials and, for external wallets, a wallet private key.] ## Skill Version(s): 1.12.4 (source: frontmatter and release evidence) ## Ethical Considerations: Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
clawhub.json
{
"emoji": "\ud83d\udc0b",
"primaryEnv": "SIMMER_API_KEY",
"requires": {
"env": [
"SIMMER_API_KEY"
],
"pip": [
"simmer-sdk>=0.11.1"
]
},
"envVars": [
{
"name": "SIMMER_API_KEY",
"required": true,
"description": "Your Simmer SDK API key \u2014 get from simmer.markets/dashboard"
},
{
"name": "WALLET_PRIVATE_KEY",
"required": false,
"description": "Only needed for external-wallet self-custody trading. Not required when using managed wallets."
}
],
"cron": null,
"autostart": false,
"automaton": {
"managed": true,
"entrypoint": "copytrading_trader.py"
},
"tunables": [
{
"env": "SIMMER_COPYTRADING_WALLETS",
"type": "string",
"default": "",
"label": "Whale wallet addresses (comma-separated)"
},
{
"env": "SIMMER_COPYTRADING_MAX_USD",
"type": "number",
"default": 50,
"range": [
1,
200
],
"step": 5,
"label": "Max bet per trade"
},
{
"env": "SIMMER_COPYTRADING_TOP_N",
"type": "number",
"default": 5,
"range": [
1,
20
],
"step": 1,
"label": "Positions to track"
},
{
"env": "SIMMER_COPYTRADING_MAX_TRADES",
"type": "number",
"default": 5,
"range": [
1,
20
],
"step": 1,
"label": "Max trades per run"
},
{
"env": "COPYTRADING_CADENCE_MODE",
"type": "string",
"default": "polling",
"enum": ["polling", "balanced", "aggressive"],
"label": "Cadence mode — set higher for more active polling (polling=10 trades/run, balanced=50, aggressive=200)"
},
{
"env": "COPYTRADING_FORCE_SIMMER_VENUE",
"type": "string",
"default": "",
"label": "Force Simmer ($SIM) venue — set to 'true' to disable auto-routing above-cap trades to Polymarket"
}
]
}activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/simmer/skills/polymarket-copytrading",
"sourceUrl": "https://clawhub.ai/simmer/skills/polymarket-copytrading",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-09T05:02:09.073Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-simmer-polymarket-copytrading/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-simmer-polymarket-copytrading/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-09T05:02:09.073Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "4.7K downloads",
"href": "https://clawhub.ai/simmer/polymarket-copytrading",
"sourceUrl": "https://clawhub.ai/simmer/polymarket-copytrading",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-09T05:02:09.073Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "1.12.4",
"href": "https://clawhub.ai/simmer/polymarket-copytrading",
"sourceUrl": "https://clawhub.ai/simmer/polymarket-copytrading",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-09-23T03:10:45.894Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-simmer-polymarket-copytrading/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-simmer-polymarket-copytrading/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 1.12.4",
"description": "- Bumped version to 1.12.4. - Minor documentation updates in SKILL.md. - Removed deprecated skill-card.md file. - No changes to user-facing features or logic.",
"href": "https://clawhub.ai/simmer/polymarket-copytrading",
"sourceUrl": "https://clawhub.ai/simmer/polymarket-copytrading",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-09-23T03:10:45.894Z",
"isPublic": true
}
]
}Record generated Oct 9, 2026.
