An automated trading tool designed to track and replicate the positions of high-performing Polymarket wallets in real-time.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install polymarket-whale-copier
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install polymarket-whale-copier using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Polymarket Whale Copier?
The Polymarket Whale Copier is a robust automation framework that allows users to follow the 'smart money' on the world's largest prediction market. By utilizing public APIs, this tool monitors specific wallet addresses and replicates their trades according to your specific financial parameters. As part of the growing ecosystem of Openclaw Skills, it provides a bridge between high-level market analysis and automated execution.
This skill is built for traders who want to capture alpha by following proven leaderboards without the need for constant manual oversight. It focuses on safety and transparency, offering a local-first approach where your private keys remain under your control while the bot handles the heavy lifting of monitoring and order execution. Incorporating Openclaw Skills like this into your workflow allows for a data-driven approach to decentralized prediction markets.
Polymarket Whale Copier Use Cases
- Automatically following the trades of top-ranked users on the Polymarket leaderboard.
- Implementing a disciplined copy-trading strategy with strict minimum and maximum investment caps.
- Reducing manual effort by utilizing auto-redemption features for winning market positions.
- Testing new trading hypotheses using the dry-run simulation mode within the Openclaw Skills framework.
How Polymarket Whale Copier Works
- The system initiates a monitoring cycle that polls the Polymarket public API every 60 seconds to check the target wallet's activity.
- When a new trade is detected, the skill analyzes the transaction size and the specific market contract involved.
- The tool applies your local configuration filters, such as the copy percentage and USD limits, to determine the appropriate trade size for your account.
- If the trade meets all safety criteria, it signs and broadcasts the order to the Polymarket exchange using your provided private key.
- The lifecycle concludes with a logging phase where the trade details and execution status are recorded for later review.
Polymarket Whale Copier Setup
To get started with this skill, set your private key as an environment variable and initialize the tracking script via your terminal:
# Define your Polymarket private key
export POLYMARKET_KEY="0xYourPrivateKey"
# Launch the copier with a specific target and percentage
python3 scripts/copy_trader.py --target 0xWhaleWalletAddress --percent 10
You can also manage the lifecycle of the bot using the included shell scripts:
./scripts/start.sh
./scripts/status.sh
Polymarket Whale Copier Data Schema & Taxonomy
The skill manages its operations through a structured configuration file and output logs. This ensures that users of Openclaw Skills have full visibility into their automated actions.
| Component | Format | Purpose |
|---|---|---|
config.json |
JSON | Stores target wallet, risk limits, and operational intervals |
logs/ |
Directory | Contains timestamped text files of every detected whale trade and executed order |
Environment |
Variable | Securely handles the POLYMARKET_KEY for transaction signing |
Polymarket Whale Copier Advanced Features
- Multi-stage risk controls including min/max USD trade sizes to prevent over-exposure.
- BUY-only mode to simplify strategies and avoid selling into illiquid markets.
- Automated redemption script that scans your portfolio and claims winning shares into USDC.
- Dry-run capability to validate the logic of your Openclaw Skills setup before committing real capital.
SKILL.md
Loading
Related Openclaw Skills
Memory Guard
Secure your agent's identity and memory files against injection attacks and unauthorized personality drift.
Image Nuke
A high-intensity image anonymization tool that strips all metadata and injects noise to defeat forensic tracking and reverse image search.
Crypto Alpha Scanner
A zero-dependency Python intelligence tool providing real-time crypto prices, sentiment analysis, and trending market data.
CompoundMind
An experience distillation engine that turns raw daily memory logs into compounding intelligence for AI agents.
SoulKeeper
SoulKeeper provides identity persistence for AI agents by auditing core rule files, detecting behavioral drift, and injecting context-aware reminders.
VidIQ
An AI-driven video intelligence tool for downloading, analyzing, and manipulating media from social platforms using ffmpeg and yt-dlp.
Featured*
