whatisgithub

What is polymarket-copy-trading-bot?

gokulgml/polymarket-copy-trading-bot — explained in plain English

Analysis updated 2026-05-18

136TypeScriptAudience · generalComplexity · 3/5Setup · moderate

In one sentence

A bot that watches a chosen Polymarket trader's activity and automatically mirrors their trades from your own wallet, with size and spend limits.

Mindmap

mindmap
  root((Polymarket copy bot))
    What it does
      Watches target trader
      Mirrors their trades
      Polls every 15 seconds
      Applies size and cap limits
    Tech stack
      TypeScript
      Node.js
      Polymarket API
    Use cases
      Mirror a trusted trader
      Limit order size
      Test with small caps
    Audience
      Prediction market users
      Automation hobbyists

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Automatically copy a chosen trader's Polymarket trades from your own account.

USE CASE 2

Scale copied trades up or down with a configurable size multiplier.

USE CASE 3

Cap spending per copied order with a hard dollar limit.

What is it built with?

TypeScriptNode.jsPolymarket API

How does it compare?

gokulgml/polymarket-copy-trading-botamet2901/asterdex-trading-botbonny1220/solana-trading-bot
Stars136136136
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatemoderatemoderate
Complexity3/54/54/5
Audiencegeneralgeneralgeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires a Polymarket wallet private key and proxy address, poll-based, so there is an inherent delay copying trades.

No license information is stated in the README.

So what is it?

This is a copy-trading bot for Polymarket, an online prediction market where people bet on the outcomes of real-world events. Copy trading means the bot watches a specific trader's activity on Polymarket and automatically places the same trades from your own account. The idea is to mirror someone whose judgment you trust without having to monitor the market yourself. The bot works by polling Polymarket's API at a configurable interval (every 15 seconds by default) to check for new activity from the target trader. When it detects a trade, it places a matching order from your wallet. You can set a size multiplier to trade proportionally larger or smaller than the target, and a hard cap in US dollars to limit how much is spent on any single copied order. A trades-only mode is available to avoid copying non-trade events like claims or other account activity. Setup requires Node.js version 20 or newer. You configure the bot by creating a file in the project folder and setting a handful of variables: the address or username of the trader to copy, your Polymarket wallet private key, and your Polymarket proxy address (which the README explains is found in the Polymarket interface and may differ from your raw wallet address). The README recommends starting with a low multiplier and a small order cap while testing. The bot is poll-based rather than real-time, so there is an inherent delay between when the target trader acts and when the copy order is placed. The FAQ notes that if very low latency is needed, a streaming approach would be required instead. The README is straightforward about what the bot does not do: it makes no profit guarantees and describes itself as a copy-trading tool rather than an arbitrage system. The disclaimer states the software is for educational purposes and the user is responsible for all outcomes from using it.

Copy-paste prompts

Prompt 1
Explain how this bot detects and copies a target trader's activity on Polymarket.
Prompt 2
How do I configure the trader address, wallet key, and proxy address for this bot?
Prompt 3
What is the difference between the size multiplier and the dollar cap settings?
Prompt 4
Why does the README say a streaming approach would be needed for very low latency copying?

Frequently asked questions

What is polymarket-copy-trading-bot?

A bot that watches a chosen Polymarket trader's activity and automatically mirrors their trades from your own wallet, with size and spend limits.

What language is polymarket-copy-trading-bot written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, Polymarket API.

What license does polymarket-copy-trading-bot use?

No license information is stated in the README.

How hard is polymarket-copy-trading-bot to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is polymarket-copy-trading-bot for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.