Automated copy trading (copytrading) bot for Polymarket that mirrors trades from top performers with intelligent position sizing and real-time execution.
Features • Quick Start • Documentation • FAQ • Support
- Overview
- How It Works
- Features
- Quick Start
- Configuration
- Docker Deployment
- Documentation
- Frequently Asked Questions
- Advanced Version
- License
- Acknowledgments
The Polymarket Copy Trading Bot is the leading open-source automated trading solution for Polymarket prediction markets. This enterprise-grade trading bot automatically replicates trades from successful Polymarket traders directly to your wallet, enabling you to mirror top performers without manual intervention. The system provides continuous 24/7 monitoring, intelligent position sizing calculations, and real-time order execution with comprehensive trade tracking.
Copy trading on Polymarket allows you to automatically mirror the trades of successful traders. When a trader you're following makes a trade, this bot instantly replicates it in your wallet with proportional position sizing based on your capital. This is the most effective way to leverage the expertise of top Polymarket traders while maintaining full control over your funds.
- Automated Trade Replication: Seamlessly mirrors trades from selected top-performing traders
- Intelligent Position Sizing: Dynamically calculates trade sizes based on capital ratios
- Real-Time Execution: Monitors and executes trades with sub-second latency
- Comprehensive Tracking: Maintains complete trade history and performance analytics
-
Trader Selection
- Identify top performers from the Polymarket Leaderboard
- Validate trader statistics using Predictfolio
- Configure trader addresses in the system
-
Continuous Monitoring
- Bot monitors trader activity using the Polymarket Data API
- Detects new positions and trade executions in real-time
- Polls at configurable intervals (default: 1 second)
-
Intelligent Calculation
- Analyzes trader's order size and portfolio value
- Calculates proportional position size based on your capital
- Applies configured multipliers and risk management rules
-
Order Execution
- Places matching orders on Polymarket using your wallet
- Implements price protection and slippage checks
- Handles order aggregation for optimal execution
-
Performance Tracking
- Maintains comprehensive trade history in MongoDB
- Tracks positions, P&L, and performance metrics
- Provides detailed analytics and reporting
This Polymarket copy trading bot provides enterprise-grade features for automated trading on Polymarket prediction markets:
| Feature | Description |
|---|---|
| Multi-Trader Support | Track and copy trades from multiple Polymarket traders simultaneously with independent configuration for each trader |
| Smart Position Sizing | Automatically adjusts trade sizes based on your capital relative to trader's capital, ensuring proportional risk management |
| Tiered Multipliers | Apply different multipliers based on trade size ranges for sophisticated risk management and capital allocation |
| Position Tracking | Accurately tracks purchases and sells even after balance changes with complete historical context |
| Trade Aggregation | Combines multiple small trades into larger executable orders to optimize execution and reduce gas costs |
| Real-Time Execution | Monitors Polymarket trades every second and executes instantly with minimal latency for optimal entry prices |
| MongoDB Integration | Persistent storage of all trades, positions, and historical data for comprehensive analytics |
| Price Protection | Built-in slippage checks and price validation to avoid unfavorable fills and protect your capital |
| 24/7 Monitoring | Continuous automated monitoring of selected traders without manual intervention |
| Open Source | Free and open-source codebase allowing full transparency and customization |
- Monitoring Method: Polymarket Data API with configurable polling intervals for real-time trade detection
- Default Polling Interval: 1 second (configurable via
FETCH_INTERVAL) for optimal balance between speed and API usage - Database: MongoDB for persistent storage and analytics of all trading activity
- Network: Polygon blockchain for low-cost transactions and efficient gas usage
- Architecture: TypeScript-based modular design with comprehensive error handling and logging
- Language: Built with TypeScript for type safety and maintainability
- Deployment: Supports Docker deployment for easy setup and production use
Before you begin, ensure you have the following:
- Node.js v18.0.0 or higher
- MongoDB Database (MongoDB Atlas free tier recommended)
- Polygon Wallet with USDC and POL/MATIC for gas fees
- RPC Endpoint (Infura or Alchemy free tier)
# 1. Clone the repository
git clone https://github.com/earthskyorg/polymarket-copy-trading-bot.git
cd polymarket-copy-trading-bot
# 2. Install dependencies
npm install
# 3. Run interactive setup wizard
npm run setup
# 4. Build the project
npm run build
# 5. Verify configuration
npm run health-check
# 6. Start the bot
npm start📖 Detailed Setup: For comprehensive setup instructions, see the Getting Started Guide
The following environment variables are required for the bot to function:
| Variable | Description | Example |
|---|---|---|
USER_ADDRESSES |
Comma-separated list of trader addresses to copy | '0xABC..., 0xDEF...' |
PROXY_WALLET |
Your Polygon wallet address | '0x123...' |
PRIVATE_KEY |
Wallet private key (without 0x prefix) | 'abc123...' |
MONGO_URI |
MongoDB connection string | 'mongodb+srv://...' |
RPC_URL |
Polygon RPC endpoint URL | 'https://polygon...' |
TRADE_MULTIPLIER |
Position size multiplier (default: 1.0) | 2.0 |
FETCH_INTERVAL |
Monitoring interval in seconds (default: 1) | 1 |
To identify traders worth copying, follow these steps:
- Visit the Leaderboard: Navigate to Polymarket Leaderboard
- Evaluate Performance: Look for traders with:
- Positive P&L over extended periods
- Win rate above 55%
- Active and consistent trading history
- Verify Statistics: Cross-reference detailed stats on Predictfolio
- Configure: Add verified wallet addresses to
USER_ADDRESSESin your configuration
📖 Complete Configuration Guide: See Quick Start Documentation for detailed configuration options
Deploy the bot using Docker Compose for a production-ready, containerized setup:
# 1. Configure environment variables
cp .env.example .env
# Edit .env with your configuration
# 2. Start services
docker-compose up -d
# 3. View logs
docker-compose logs -f bot- Isolated Environment: Runs in a containerized environment
- Automatic Restart: Configured for automatic restart on failure
- MongoDB Integration: Includes MongoDB service in the stack
- Health Checks: Built-in health monitoring
📖 Docker Documentation: For complete Docker setup and configuration, see Docker Deployment Guide
- 🚀 Getting Started Guide - Comprehensive beginner's guide with step-by-step instructions
- ⚡ Quick Start Guide - Fast setup guide for experienced users
- Docker Guide - Complete Docker deployment documentation
- Multi-Trader Guide - Managing multiple traders
- Tiered Multipliers - Advanced position sizing configuration
- Position Tracking - Understanding position management
A Polymarket copy trading bot is an automated software that monitors successful traders on Polymarket and automatically replicates their trades in your wallet. This bot provides 24/7 monitoring, intelligent position sizing, and real-time execution to mirror top-performing traders.
The bot continuously monitors selected traders using the Polymarket Data API. When a trader makes a trade, the bot calculates the proportional position size based on your capital, applies configured multipliers, and executes the trade on your behalf with minimal latency.
Yes! This is a completely free and open-source Polymarket copy trading bot. The code is available on GitHub under the ISC license, allowing you to use, modify, and distribute it freely.
You need:
- Node.js v18.0.0 or higher
- MongoDB database (free tier available on MongoDB Atlas)
- Polygon wallet with USDC and POL/MATIC for gas fees
- RPC endpoint (free tier available on Infura or Alchemy)
- Visit the Polymarket Leaderboard
- Look for traders with positive P&L over extended periods
- Verify statistics on Predictfolio
- Add their wallet addresses to your bot configuration
Yes! The bot supports multi-trader functionality, allowing you to copy trades from multiple traders simultaneously with independent configuration for each trader.
The bot is open-source, allowing you to review all code. Your private keys are stored locally and never transmitted. The bot only executes trades you've configured, and you maintain full control over your funds at all times.
This automated bot provides:
- 24/7 monitoring without manual oversight
- Instant trade replication (sub-second latency)
- Intelligent position sizing based on capital ratios
- Comprehensive trade history and analytics
- Ability to copy multiple traders simultaneously
The bot itself is free. You only pay for:
- Polygon network gas fees (typically very low)
- Optional MongoDB Atlas hosting (free tier available)
- Optional RPC endpoint (free tier available)
Yes! The bot supports:
- Custom position multipliers
- Tiered multipliers based on trade size
- Configurable polling intervals
- Multiple trader configurations
- Risk management rules
An advanced version with Real-Time Data Stream (RTDS) monitoring is available as a private repository.
- Fastest Trade Detection: Near-instantaneous trade replication
- Reduced Latency: Optimized for minimal execution delay
- Lower API Load: More efficient data streaming architecture
- Superior Performance: Enhanced copy trading (copytrading) capabilities
A high-performance trading bot for Polymarket built with Rust is also available for advanced users seeking maximum performance.
This project is licensed under the ISC License. See the LICENSE file for details.
This project is built using the following technologies and services:
- Polymarket CLOB Client - Official Polymarket trading client library
- Predictfolio - Trader analytics and performance metrics
- Polygon Network - Low-cost blockchain infrastructure for efficient trading
If you're looking for a Polymarket copy trading bot, automated trading bot for Polymarket, Polymarket trading automation, copy trading strategy, or Polymarket bot tutorial, you've found the right solution. This is the best free open-source Polymarket trading bot available.
For questions, issues, or feature requests:
- Telegram: @opensea712
- Twitter: @shinytechapes
Built with ❤️ for the Polymarket community