On this page

PolyTortoise docs.

Set up the bot, test wallets in paper mode, and switch live when you are ready.

Docs updated 23 September 2026.

paper mode

$10k · free

live fee

1% per copy buy

live leaderboard

opt-in P&L

Quickstart

Start in free paper mode. Do not fund anything until you have watched enough copied trades to understand the leaders and settings you picked.

telegramOpen @PolyTortoise_bot

/startCreates your paper account and opens the main menu.

top 3Tap auto-copy top 3, or use /leaders and pick wallets manually.

/statusSee whether the bot is ready, waiting, or blocked, plus the next action.

/dashboardOpen the Mini App to watch positions, equity, trades, settings, and fees.

Results is the aggregate paper tape. Leaderboard is opt-in all-time Polymarket account P&L from live users. Paper numbers never appear on the live leaderboard.

Paper mode

Paper mode mirrors real market prices into a virtual portfolio. It is designed to answer one question before live trading: would this copy setup have made sense with your sizing?

starting balance

$10,000 virtual USDC

Enough room to test several leaders without depositing funds.

data source

Live Polymarket markets

Paper fills track public market data and resolve into a paper PnL ledger.

review loop

Open Trades and the paper tape

Use the Mini App Trades page for your history and Results for the aggregate public tape.

reset

Use /reset or /support

/reset restores your paper account to $10,000. Use /support if something still looks wrong.

Paper positions settle at the market's official payout: $1 or $0 a share, or $0.50 when a market resolves 50/50. A 50/50 settlement is listed on its own and counts as neither a win nor a loss. Take-profit and stop-loss trigger on what the whole position could be sold for in the order book's bids, and sell only if a fresh book still meets the threshold.

If Polymarket still hasn't resolved a market 14 days after its end date, the position stays open but is counted at its best bid, or $0 without one, and shown on its own line in /portfolio; it settles normally if the market resolves later. A position whose market id can't match any Polymarket market is counted at $0, and trades in such markets are not copied.

Copy targets

PolyTortoise can copy leaderboard wallets or any wallet address you paste. Account settings provide the default; each leader can then override the sizing style, leader-size floor, entry-price band, and copied direction.

/leadersBrowse the current leaderboard cache and add known active wallets quickly.

/watch 0x...Add a specific wallet address as a copy target.

Buy/sell filtersChoose whether a target copies buys, sells, or both. This prevents unwanted mirror behavior.

Per-leader sizingUse account sizing with a hard maximum, or choose a fixed amount for that leader's eligible trades.

Per-leader filtersSet a minimum leader trade and accepted entry-price band without changing every other target.

Recent decisionsSee copied, submitted, missed, skipped, and failed decisions with the useful reason inside your private Leaders page.

Mini App pages

The Telegram Mini App is the dashboard. Commands still work, but the dashboard is faster for reviewing positions and changing settings.

Portfolio

Open positions

Paper and live balances, open positions, pending orders, and exit buttons.

Leaders

Targets and decisions

Browse wallets, configure each copy target, and see why recent trades were copied or skipped.

Trade

Manual market buys

Search markets and place paper or live buys when you do not want to copy anyone.

Settings

Risk and settlement

Account sizing, max exposure, exits, alerts, and automatic-redemption retry status.

Trades

Equity and history

Closed trades, open/pending activity, and equity curve.

Fees

Live fee ledger

Shows charged, swept, and outstanding live-copy fees inside your private dashboard.

Live mode

Live mode submits real orders from a separate PolyTortoise deposit wallet created for you. Required signer material is stored encrypted. The bot does not ask for your existing wallet seed phrase.

1 Run /go_live 2 Open /deposit 3 Send pUSD or USDC.e 4 Check /status

Use the Polygon address shown by /deposit. The minimum is $25. Send pUSD or USDC.e on Polygon only. USDC.e is wrapped to pUSD automatically through the gasless relayer flow.

If spendable pUSD is too low for a new copy, PolyTortoise sends one waiting-for-balance notice for that low-balance episode. It then suppresses repeated rejected buys and checks periodically, resuming automatically after the balance increases enough for an eligible copy. Existing positions, exits, and redemption monitoring continue.

Keep paper mode running long enough to test your target list first. Live trading automates the instructions you configure; it does not guarantee profit.

Fees

Paper mode is free. Live mode charges 1% of each filled live copy buy. Exits are free, failed or unfilled copies are not charged, and manual trades are not copy fees. Polymarket's own taker fee on some markets is separate and goes to Polymarket.

Paper results simulate the costs a live copy would incur: the 1% copy fee on each copied buy, and each market's Polymarket taker fee on entry and on any exit before the market resolves. These costs reduce your virtual balance, not real money. Paper exits use the order book's bids.

Paper modeNo real-money fee. No card, deposit or subscription.

Live copy buys1% of each filled copy buy, recorded in your fee ledger. Exits are free.

Fee pageRun /dashboard, then open Fees to see charged, swept, and outstanding amounts.

Command map

These are the main customer commands registered by the live bot.

/startCreate account, open paper mode, show main menu.

/statusShow readiness, the current blocker, and the next action.

/dashboardOpen the Telegram Mini App.

/leadersBrowse ranked wallets and add copy targets.

/watchTrack a specific wallet address.

/leaderboardJoin, rename, or leave the opt-in live P&L board.

/portfolioOpen your positions and P&L.

/tradeSearch and manually buy a market outcome.

/settingsChange copy sizing, filters, exits, and alerts.

/pausePause automatic copying without deleting targets.

/resumeResume automatic copying.

/go_liveProvision your live deposit wallet.

/depositShow the Polygon funding address and accepted assets.

/withdrawSend live funds to another Polygon address.

/supportOpen private support and report a problem.

/forgetPermanently delete your PolyTortoise account data.

Public policy

PolyTortoise is a managed Telegram product. Results publishes aggregate paper activity. Leaderboard publishes real all-time Polymarket account P&L only for live users who opt in.

The live leaderboard never publishes Telegram IDs, wallet addresses, balances, settings, or trade lists. Account-specific support stays private through /support.

Read changelog View leaderboard View results Open Telegram bot