Polymarket Sniper Bot User Guide

Complete documentation for setting up, configuring, and running your automated trading strategies.

01. Prerequisites

  • Node.js: Node.js: v18 or higher.
  • Telegram Bot Token: Telegram Bot Token: Get it from @BotFather.
  • Polygon RPC Node: Polygon RPC Node: Reliable RPC URL (Alchemy/Infura recommended).
  • Private Key: Private Key: A Polygon wallet private key (New wallet recommended).

02. Installation

1. Install Dependencies

# Navigate to bot directory

cd bot

npm install

03. Configuration

Copy the example environment file and configure your credentials.

cp .env.example .env

Required .env Variables

  • TELEGRAM_BOT_TOKEN=your_token_here
  • POLYGON_RPC_URL=https://polygon-mainnet.g.alchemy.com/v2/...
  • SNIPER_DRY_RUN=true // Set to false for real trading

04. Core Features

💰 Wallet Setup

⚠️ Critical: This must be done first.
  1. Send /start in Telegram.
  2. Go to Settings -> Import Private Key.
  3. Enter your private key (encrypted locally).
  4. Check balance to ensure you have USDC and MATIC.

🎯 Sniper Mode

Auto-buy new markets based on keywords.

  • Command: /sniper
  • Add Keyword: Reply with keywords (e.g., "Trump", "Rate Cut").
  • Config: Set buy amount (USDC).
  • Start: Bot polls every 30s.

⚖️ Arbitrage Mode

Find and execute risk-free spread trades.

  • Command: /arb
  • Profit Threshold: Set min profit % (e.g., 0.5%).
  • Max Trade: Set max size per trade.

⚠️ Risk Warning

Your private keys are stored encrypted locally. Do not share your bot.db file. Always test with SNIPER_DRY_RUN=true first. Trading involves risk of loss.