Polygun-Polymarket-Sniper-Bot

Polygun — Polymarket Sniper Bot

@polygunsniperbot is a Telegram-based trading bot for Polymarket. It scans prediction markets in real time, identifies mispricings, and executes orders faster than you can open a browser tab. No web dashboard. No manual order entry. Just connect your wallet and configure your parameters.


How it works

Polymarket runs on Polygon. Every market is an on-chain orderbook where YES/NO shares trade between 0 and 1 USDC. When new information hits — a breaking news event, an early vote count, an unexpected announcement — prices adjust. The window between “news breaks” and “market reprices” is where Polygun sniper bot operates.

The bot:

  1. Monitors active Polymarket contracts continuously
  2. Compares current market prices against configurable thresholds
  3. Fires orders when a mispricing condition is met
  4. Reports fills back to you via Telegram message

All of this happens in the background. You set the rules once; the bot runs them.


Installation & setup

No server required. The bot runs on Telegram.

1. Open Telegram
2. Search: @polygunsniperbot
3. Send /start
4. Follow the wallet connection flow
5. Configure your first strategy

Wallet connection uses a read/sign flow — Polygun never has custody of your funds. Orders are signed locally and submitted on-chain.


Configuration

Once connected, you configure the bot through Telegram commands.

Basic parameters

/set_size 50          # USDC per trade
/set_max_daily 500    # daily spend cap
/set_min_liquidity 1000  # skip markets below this orderbook depth

Market filters

/filter_category politics
/filter_category sports
/filter_category crypto
/filter_all              # no category filter

Price thresholds

/snipe_below 0.08    # buy YES when price drops under 8 cents
/snipe_above 0.92    # buy YES when price exceeds 92 cents

You can run multiple strategies simultaneously. Each strategy is stored as a named profile.

/profile_create election_sniper
/profile_create crypto_arb
/profile_list
/profile_switch election_sniper

Copy trading

The copy trading module tracks specified wallets and mirrors their trades automatically.

/copy_add 0xWALLET_ADDRESS
/copy_remove 0xWALLET_ADDRESS
/copy_list
/copy_allocation 30      # USDC per copied trade
/copy_max_daily 300      # daily cap for copy trades

When a tracked wallet places an order, Polygun fires a matching order on your behalf within milliseconds. You can follow multiple wallets at once with separate allocation limits per wallet.

/copy_add 0xABC... --allocation 50
/copy_add 0xDEF... --allocation 25

Copy trading can run alongside your own sniper strategies or as a standalone mode.


Alerts & notifications

Every trade the bot places sends a Telegram notification:

✅ FILLED
Market: Will X win the election?
Side: YES
Price: $0.07
Size: 50 USDC
Shares: 714.3
Tx: 0x...

You also get alerts when:

To enable dry run mode (alerts only, no execution):

/dryrun on
/dryrun off

Commands reference

Command Description
/start Connect wallet and initialize bot
/status Show active strategies and today’s spend
/pause Pause all strategies
/resume Resume all strategies
/positions List open positions
/history Last 20 trades
/pnl Realized PnL summary
/set_size [n] Set default trade size in USDC
/set_max_daily [n] Set daily spend cap
/snipe_below [n] Buy trigger: price below threshold
/snipe_above [n] Buy trigger: price above threshold
/copy_add [wallet] Add wallet to copy list
/copy_list Show tracked wallets
/dryrun on/off Toggle simulation mode
/profile_create [name] Create a named strategy profile
/profile_switch [name] Switch active profile
/help Full command list

Architecture

Telegram interface
      │
      ▼
Bot core (Node.js)
      │
      ├── Market scanner
      │     └── Polls Polymarket CLOB API
      │
      ├── Strategy engine
      │     ├── Sniper strategies
      │     └── Copy trading module
      │
      ├── Order executor
      │     └── Signs + submits via Polygon RPC
      │
      └── Notification dispatcher
            └── Telegram Bot API

The scanner runs a polling loop against the Polymarket Central Limit Order Book API. When a strategy condition fires, the order executor builds a signed transaction and broadcasts it to the Polygon network. Latency from condition trigger to on-chain submission is typically under 500ms on a standard VPS.


FAQ

Do I need to run anything on my own server?
No. The bot is hosted. You interact entirely through Telegram.

Does Polygun hold my funds?
No. Your wallet stays in your control. The bot signs transactions on your behalf using a session key that you can revoke at any time.

What happens if I hit my daily cap?
The bot pauses automatically and sends you a notification. It resets at midnight UTC.

Can I use it on mobile?
Yes. Since it runs through Telegram, everything works from your phone.

Is there a minimum wallet balance?
Polymarket requires USDC on Polygon. Keep enough for your configured position sizes plus gas.



Not financial advice. Prediction markets carry risk.