Polyman/Docs
Live

Docs

Polyman Bot documentation and command reference

Quick Start

Polyman is a Telegram-native copy trading bot for Polymarket. Get started in under 2 minutes — no dashboard, no browser extension required.

Step 1 — Open the bot

Search for @PolymanBot on Telegram or click the link below.

https://t.me/PolymanBot

Step 2 — Connect your wallet

Send your Polygon wallet address to the bot. Polyman will verify ownership by asking you to sign a message.

/wallet 0xYourPolygonWalletAddress

Step 3 — Browse the leaderboard

Find top traders ranked by 30-day PnL and win rate.

/leaderboard

Step 4 — Start copy trading

Copy a trader with default settings (1:1 ratio, $100 max bet, $500 daily loss limit).

/copy domahhh

Step 5 — Customize settings (optional)

/copysettings domahhh
  ratio: 0.5
  max_bet: 50
  daily_loss: 200
  categories: Politics, Crypto

Bot Commands

All commands are sent as Telegram messages to @PolymanBot. Arguments in <angle brackets> are required; [square brackets] are optional.

Command
Description
Category
/start
Initialize the bot and connect your wallet
Setup
/wallet[address]
View or update your connected Polygon wallet
Setup
/leaderboard[page]
Browse top traders ranked by 30d PnL
Discovery
/trader<name|wallet>
View detailed stats for a specific trader
Discovery
/markets[category]
List hot markets sorted by 24h volume
Discovery
/market<slug|id>
Get detailed info and probability for a market
Discovery
/copy<name|wallet>
Start copy trading a specific trader
Copy Trading
/uncopy<name|wallet>
Stop copy trading a trader
Copy Trading
/copysettings<name>
Configure copy ratio, max bet, and daily loss limit
Copy Trading
/portfolio
View your current open positions and PnL
Portfolio
/pnl[7d|30d|all]
View your profit and loss summary
Portfolio
/history[limit]
View your trade history
Portfolio
/alerts
Manage your market and trader alerts
Alerts
/watch<name|wallet>
Watch a trader for real-time trade alerts
Alerts
/unwatch<name|wallet>
Stop watching a trader
Alerts
/help
Show all available commands
General
/status
Check bot status and uptime
General

Copy Trading

Copy trading automatically mirrors a trader's positions on Polymarket. When the trader buys or sells a market, Polyman executes the same trade from your wallet at your configured ratio.

Configuration Parameters

Parameter
Type
Default
Description
ratiofloat1.0Copy bet size as a multiple of the original. 0.5 = half size.
max_betUSDC100Maximum USDC per copied trade. Protects against large single bets.
daily_lossUSDC500Stop copying if daily loss exceeds this amount.
categorieslistallOnly copy trades in specified categories (e.g. Politics, Crypto).
min_probfloat0.05Minimum market probability to copy. Filters out near-zero bets.
max_probfloat0.95Maximum market probability to copy. Filters out near-certain bets.

Example: Conservative Setup

/copysettings domahhh
  ratio: 0.25       # 25% of original bet size
  max_bet: 25       # Never more than $25 per trade
  daily_loss: 100   # Stop if down $100 in a day
  min_prob: 0.1     # Skip markets below 10%
  max_prob: 0.9     # Skip markets above 90%

Alerts & Notifications

Polyman sends real-time Telegram messages for trade executions, daily PnL summaries, and whale activity on watched traders.

Alert Types

Trade Executed
Sent immediately when a copy trade is placed. Includes market, position, size, and current probability.
Trade Failed
Sent if a copy trade fails. Includes reason (insufficient balance, slippage, etc.) and retry status.
Daily PnL Summary
Sent at midnight UTC. Includes total PnL, win/loss count, and top performing copied trade.
Whale Alert
Sent when a watched trader opens a new position. Includes market, direction, and size.
Loss Limit Hit
Sent when daily loss limit is reached. Copy trading is paused until the next UTC day.

Risk Management

Polyman includes multiple layers of risk protection to prevent catastrophic losses from copy trading.

Per-Trade Max Bet

Set a maximum USDC amount per copied trade. Even if the original trader bets $100K, your copy is capped at your limit.

Daily Loss Limit

If your total daily PnL drops below the configured threshold, all copy trading is automatically paused until the next UTC day.

Probability Filters

Skip markets that are too certain (>90%) or too unlikely (<10%) to avoid copying degenerate bets.

Category Filters

Only copy trades in categories you understand. Avoid copying political trades if you don't follow politics.

Slippage Protection

Polyman sets a 2% slippage tolerance by default. Trades that would execute at worse prices are rejected.

FAQ