polymarket-whale-copier

What This Skill Does

The polymarket-whale-copier is an automated trading agent skill designed to bridge the gap between amateur traders and proven "whale" participants on the Polymarket platform. By monitoring specific wallet addresses in real-time, the skill detects new position entries and automatically calculates, filters, and executes mirror trades based on your predefined risk parameters. It removes the need for constant manual market monitoring, ensuring you never miss an entry when a high-performing wallet places a bet.

Installation

To integrate this skill into your environment, use the OpenClaw package manager: clawhub install openclaw/skills/skills/cassh100k/polymarket-whale-copier

Once installed, you must configure your environment variables by setting the POLYMARKET_KEY to your private key. Always verify your config.json settings, specifically dry_run mode, before enabling live trading. Ensure your account is sufficiently funded with USDC to support the specified copy percentages.

Use Cases

1. Alpha Following: Automatically mirror the positions of the top-ranked traders on the Polymarket leaderboard to improve your win rate.
2. Portfolio Diversification: Use the tool to follow multiple successful wallets simultaneously, allowing you to diversify your risk across different market insights.
3. Automated Redemption: Beyond just copying trades, use the auto-redemption feature to harvest your profits from winning positions without manual intervention, saving you significant time.
4. Risk-Controlled Copying: Use the min_trade_usd and max_trade_usd caps to ensure your automated trading doesn't overexpose your account to a single whale's risky behavior.

Example Prompts

1. "OpenClaw, start the polymarket-whale-copier with the target address 0x4ffe49ba...609f71 and set my copy percentage to 5%."
2. "Show me the status of the current copy trading session and list the last 5 trades executed by the agent."
3. "Enable dry_run mode for the whale copier and check if there are any pending redemptions to claim for my existing positions."

Tips & Limitations

• Dry Run First: Always run the bot in dry_run mode for several cycles to ensure your risk settings perform as expected before committing real funds.
• Risk Management: Remember that past whale performance does not guarantee future results. Start with conservative copy_percent settings.
• API Reliance: This tool relies on the public Polymarket API. If the API is under heavy load or experiences downtime, update latency may occur.
• Security: Never expose your POLYMARKET_KEY. Keep your configuration files secure and never commit them to public repositories.