Skip to content
On this page
operating manual

PolyTortoise docs.

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

Docs updated 12 August 2026.

paper mode
$10k ยท free
live fee
1% filled copy
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.

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 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 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 live leaderboard View paper tape Open Telegram bot