docs / copy trading

Copy trading

Pick the wallets you want to mirror. The bot watches their on-chain activity, sizes each entry by your rules, and submits the order from your wallet.

Two ways to add a trader

  • Manually — tap 🪞 Copy Trade → + Add Trader and paste any Polymarket wallet address. The bot validates the checksum, fetches their open positions and recent trades so you can sanity-check the wallet, then asks you to nickname it (optional, max 64 characters) before saving.
  • From a share or follow link — anyone can share their entire copy setup with a deep link. Tapping it opens the bot, shows a preview of the setup, and adds all the traders with one tap. Single-trader follow links work the same way for one wallet.
Telegram conversation showing the Add Trader flow — paste an address, the bot fetches stats, prompts for a nickname, then confirms the trader was added
Add Trader walkthrough — paste address → preview → nickname → added

The Copy Trade dashboard

Open 🪞 Copy Trade any time to see status, your active sizing mode, and the first five mirrored traders. The header shows one of three statuses:

  • ✅ Active — rules configured, mirroring is on.
  • ⏸ Paused — rules configured, you've hit Pause All.
  • ⚠️ Rules not configured — you need to run the wizard once before any trade fires.

Tap 👥 Manage to see the full paginated list (8 per page). Each trader row opens a detail view where you can pause that single wallet, resume it, or remove it without affecting the others.

Copy Trade dashboard in Telegram with Rules not configured warning
Copy Trade dashboard — before rules are configured, copies are disabled

After you add your first trader, the bot prompts you to configure your copy rules right away — without rules in place, no copies will execute.

Bot prompt asking the user to set up copy rules now or later
The bot nudges you to set up rules right after adding a trader

Sharing your setup

Tap 🔗 Share to generate a deep link that imports your full copy list (or a single trader) with one tap. Both the Mirror button on the leaderboard and your in-bot Share button produce links of this kind. See Sharing & discovery for the full breakdown.

Settings: the 6-step wizard

Before any trade fires, you set your copy rules. The first time you open ⚙️ Settingsthe bot walks you through a 6-step wizard. Every step has presets and a custom input.

Step 1 — Trade size mode

The shape of how each copied trade is sized. Three options:

ModeWhat it meansExample
💵 FixedEvery copied trade is the same dollar amount, regardless of leader size.Always $25 per trade.
📊 PercentageTrade size is a percentage of what the leader traded.50% of leader → leader buys $400, you buy $200.
⚖️ PortfolioMultiplier on what their position would be, scaled to your portfolio size.1.0× — match their relative position weight.

Step 2 — Size value

The number that goes with the mode you picked.

ModePresetsCustom range
Fixed$10 · $25 · $50 · $100min $1.10
Percentage10% · 25% · 50% · 100%1% – 1000%
Portfolio0.5× · 1× · 2×any positive multiplier

The $1.10 floor is a hard minimum on every trade — Polymarket's order book rejects anything smaller after fees, so the bot enforces it.

Step 3 — Max per trade

A hard cap on any individual copied trade, in dollars. If your sizing rule produces something larger, it gets clipped down. Useful with Percentage or Portfolio modes where the leader occasionally goes huge.

Presets: $10 · $25 · $50 · $100 · custom (min $1.10) · Skip (No Cap).

Step 4 — Per-market limit

Total dollars you'll commit to any single market across all of your copied trades. Once you've hit the limit on a market, additional entries from any leader are skipped.

Presets: $50 · $100 · $200 · $500 · custom (min $1) · Skip (No Limit).

Step 5 — Price range

Outcome price band you're willing to enter at, in cents. Polymarket prices range (highly unlikely) to 99¢ (near-certain). Trades outside your band are skipped.

Presets: 2¢–98¢ · 5¢–95¢ · 10¢–90¢ · 30¢–70¢ · custom (any range within 1–99) · Skip (Any).

Why use this: a tight band like 30¢–70¢ filters out late entries on markets that have already mostly resolved and lottery-ticket entries on long shots.

Step 6 — Slippage tolerance

How much price movement between the leader's fill and your fill you'll accept, expressed in basis points (or as a percentage in the UI).

Presets: 1% · 2% · 5% · 10% · custom (0%100%) · 🎯 Exact Price (zero tolerance) · ∞ Any Price (no slippage check).

Tighter slippage means more trades will be skipped if the book moved between the leader's fill and yours. Looser slippage means you'll catch more entries but at potentially worse prices.

Notification threshold

Independent of the wizard, you can set 🔔 Notify Min from the Manage Settings view. Trades smaller than this dollar amount fire silently — useful when you're mirroring an active scalper and don't want a notification on every $5 entry.

Presets: $1 · $5 · $10 · $25 · custom · None (notify on every fill).

Editing one setting at a time

Once the wizard is complete, you don't need to re-run it to change one thing. Open ⚙️ Settings → ✏️ Manage and tap any field to edit it inline. Each editable field has a clear button (✖️) to reset it back to "not set".

FieldWhat it controlsClear effect
💰 Trade SizeMode + value (Steps 1–2)Required — can't be cleared.
📈 Max TradePer-trade dollar capNo cap.
🏦 Market LimitPer-market total capNo limit.
🎯 Price RangeAcceptable outcome pricesAny (1¢–99¢).
⚡ SlippageTolerance vs. leader's fillAny price.
🔔 Notify MinSmallest trade that pings youNotify on every fill.

Pausing

Two granularities:

  • Pause one trader — open the trader's detail view in 👥 Manage and tap ⏸ Pause. Their entries stop firing; everyone else keeps going.
  • Pause everything — from ⚙️ Settings tap ⏸ Pause All. Mirroring stops globally until you tap ▶️ Resume All. Useful when you're away or want to manually clean up first.
Pausing doesn't close existing positions. It only stops new copy trades from being placed. To exit a position, withdraw via Polymarket directly using your exported seed until in-bot exits ship.