Practical overview
When it fits
Use it when you want a locally configured application to follow selected Polymarket traders and need controls for copied trade sizing and position monitoring.
Who it is for
- Polymarket users seeking to automate copying trades from selected accounts.
- Operators comfortable configuring a Polygon wallet, RPC endpoint, MongoDB and local application environment.
Documented uses
- Monitor and copy trades from one or more selected Polymarket traders.
- Choose percentage, fixed or adaptive sizing, and apply multipliers or tiered sizing.
- Review trader performance, copy-trading history and position data in the dashboard.
- Set order and volume limits, preview mode and trade aggregation preferences.
Requirements & limits
The repository is public and identifies the project as open source. The technical record lists an ISC license, while the README displays an MIT license badge; inspect the repository licensing files to resolve the difference.
- Requires Node.js v18 or later and MongoDB for the documented standard setup.
- Trading configuration requires a Polygon wallet, private key and RPC endpoint; the README also names USDC and POL (MATIC) for gas.
- The README describes monitoring trades every second and real-time execution.
- Preview mode is configurable and shown as false by default in the configuration table.
- The dashboard and terminal mode are both documented; Docker Compose is also described as a deployment option.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Prepare a local installation
Install the bot and configure its environment before building or starting it.
Before you start
- Node.js v18 or later
- MongoDB connection string
- Polygon wallet and private key
- Trader wallet addresses
- Polygon RPC endpoint
Steps
Clone the repository and enter its project directory.
Run npm install, then copy .env.example to .env.
Set trader addresses, wallet credentials, MongoDB URI and Polygon RPC URL in .env.
Expected outcome
The project is installed with the environment values the README says are needed for a subsequent build and run.
Guide limitations
- These steps cover installation and configuration only; they do not verify a successful build or trading setup.
- The README requires wallet credentials in the environment configuration.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 10 October 2026
- Original website title
- shmlkv/polymarket-copy-trading-bot · Official homepage title · retained in its source language

