operating manual

PolyTortoise docs.

Telegram-native Polymarket copy trading, documented for users who want to test first, inspect the tape, and then decide whether live mode is worth funding.

paper trial
$10k free
live fee
1% filled copy
public proof
/results

Quickstart

Start in paper mode. Do not fund anything until you have watched enough copied trades to trust 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.
/portfolioOpen the Mini App dashboard to watch open positions, equity, trades, settings, and fees.
The website results are public paper-mode data. They are useful for transparency, but your own copied leaders and sizing are what matter.

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

Use /trades and /results

Review open positions, closed outcomes, equity curve, and latest public tape.

reset

Ask support if stuck

If your paper bankroll is exhausted or stale, support can reset the paper state.

Copy targets

PolyTortoise can watch leaderboard wallets or any wallet address you paste. The important controls are size, side filters, and when a copied position should be exited.

/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-trade sizeSet a maximum copied size so one leader cannot consume the whole account.

Mini App pages

The Telegram Mini App is the control surface. The bot still works from commands, but the Mini App is faster for reviewing positions and changing settings.

Portfolio

Open positions

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

Leaders

Target discovery

Browse ranked wallets and add them as copy targets.

Trade

Manual market buys

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

Settings

Size and exits

Trade size, max exposure, take-profit, stop-loss, alerts, and copy behavior.

Trades

Equity and history

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

Fees

Live fee ledger

Shows charged, swept, and outstanding live-copy fees.

Live mode

Live mode submits real orders from your PolyTortoise wallet. The bot creates and uses a per-user trading wallet, stores the required signer material encrypted, and does not ask for an external seed phrase.

1 Create wallet 2 Fund USDC + gas 3 Run /go_live 4 Watch /fees

Keep paper mode running long enough to prove your target list first. Live trading is not a promise of profit; it is automation of the instructions you configure.

Fees

Paper mode has no fee. Live mode charges 1% of confirmed filled copied notional. Manual trades, failed copies, and paper fills are not live copy fees.

Paper mode0%. No card, no deposit, no subscription.
Live copy fills1% of confirmed filled copied notional, recorded in your fee ledger.
Fee pageUse the Mini App /fees page to see charged, swept, and outstanding amounts.

Command map

Core commands are intentionally short because Telegram users need speed.

/startCreate account, open paper mode, show main menu.
/leadersBrowse ranked wallets and add copy targets.
/watchTrack a specific wallet address.
/portfolioOpen portfolio Mini App.
/tradeSearch and manually buy a market outcome.
/settingsChange copy sizing, filters, exits, and alerts.
/feesReview live-copy fee ledger.

Public policy

PolyTortoise is a managed Telegram product, not an open-source bot. The parts customers need for trust and operation are public: docs, release notes, results, fees, and support expectations.

If a public GitHub space is added later, it should be for docs, roadmap notes, and feature requests. Product support still happens through Telegram or Discord so account-specific questions do not end up in public.