polygunsniperbot

🎯 PolygunBot

Automated sniping. No guessing. No lag. Just fills.

PolygunBot is a multi-platform sniper bot built for speed. It monitors listings, detects targets, and fires buy orders faster than any manual workflow. If you’ve ever lost a drop because you were 300ms too slow, this is the fix.

👉 polygunsniperbot.com

What It Does

PolygunBot connects to multiple marketplaces and waits. The moment a matching listing appears, it executes. The cycle from detection to order submission runs under 80ms on a standard VPS.

Core behavior:

Scans target platforms at configurable polling intervals
Matches listings against your filter rules (price ceiling, seller rating, item condition, keyword blocklist)
Fires buy orders via authenticated API sessions
Logs every action with timestamps, response codes, and order IDs
Sends alerts to Discord, Telegram, or a webhook of your choice

Supported Platforms

Platform	Status	Auth Method
StockX	✅ Live	Cookie / Session
GOAT	✅ Live	API Token
Grailed	✅ Live	Cookie / Session
eBay	✅ Live	OAuth 2.0
Whatnot	🧪 Beta	Cookie / Session
Fanatics Collect	🔜 Planned	TBA

Add a new platform by dropping a connector class into src/connectors/ and registering it in config.yaml. The base connector interface is documented in docs/connectors.md.

Installation

git clone https://github.com/polygunbot/polygunbot.git
cd polygunbot
python -m venv .venv
source .venv/bin/activate       # Windows: .venv\Scripts\activate
pip install -r requirements.txt
cp config.example.yaml config.yaml

Edit config.yaml before running anything. At minimum, set your credentials and at least one target rule.

Configuration

platforms:
  stockx:
    enabled: true
    auth:
      cookie: "YOUR_SESSION_COOKIE"
    polling_interval_ms: 200

targets:
  - platform: stockx
    keyword: "Jordan 4 Bred"
    max_price_usd: 320
    size: "10.5"
    condition: new

notifications:
  discord_webhook: "https://discord.com/api/webhooks/YOUR_WEBHOOK"
  telegram_bot_token: "YOUR_BOT_TOKEN"
  telegram_chat_id: "YOUR_CHAT_ID"

logging:
  level: INFO
  output: logs/polygunbot.log

Full config reference: docs/config.md

Running the Bot

# Start with default config
python main.py

# Specify a config file
python main.py --config my_config.yaml

# Dry run (logs matches, skips order submission)
python main.py --dry-run

# Run a single platform only
python main.py --platform stockx

Use --dry-run to test your filter rules against live data before committing real orders.

Project Structure

polygunbot/
├── src/
│   ├── connectors/       # One file per platform
│   ├── engine/           # Detection loop, order dispatcher
│   ├── filters/          # Rule evaluation logic
│   └── notifications/    # Discord, Telegram, webhook handlers
├── tests/
├── docs/
├── config.example.yaml
├── main.py
└── requirements.txt

Performance

On a 1 vCPU / 1GB RAM VPS co-located near platform servers:

Metric	Value
Detection latency	~45ms avg
Order submission	~30ms avg
Total cycle time	~80ms end-to-end
Memory usage	~60MB idle

Latency drops further if you run PolygunBot on infrastructure physically close to the target platform’s servers. The docs/hosting.md file covers VPS recommendations by region.

Contributing

Fork the repo
Create a branch: git checkout -b feature/your-feature
Commit your changes with a clear message
Open a pull request against main

Run the test suite before submitting: pytest tests/

Check CONTRIBUTING.md for code style guidelines and connector interface specs.

Disclaimer

PolygunBot is a personal automation tool. Review each platform’s terms of service before use. The authors take no responsibility for account suspensions or order errors.