🧙‍♂️ PolyOddWatcher

Real-time Polymarket monitoring. Self-hosted. Alert-driven. Signal-first.

PolyOddWatcher is a self-hosted, real-time dashboard for monitoring Polymarket betting markets. It detects sudden volume spikes, tracks custom watchlists, and sends instant Telegram alerts when markets move or are about to close.

Built with Python + Streamlit, designed for self-hosters, traders, and data-driven users.

---

✨ Features

• 🚀 Sudden Spike Detection
  Detects volume spikes above a configurable threshold (e.g. $2,000 in 10 minutes).

• 📊 Real-Time Dashboard
  Dark-mode UI with live charts, sorting, and Leading Outcome indicators.

• 📱 Telegram Integration
  Instant alerts with clickable market links and odds sent directly to your phone.

• 👀 Watchlists
  Monitor specific markets by Market ID or Slug.

• 💾 Historical Logging
  Automatic logging to SQLite and CSV for long-term analysis.

• 🐳 Docker Ready
  Lightweight container (Python 3.11-slim), exposed on port 7770.

---

🚀 Quick Start (Docker Compose)

Create a docker-compose.yml file:

services:
  polyoddwatcher:
    image: sgdva/polyoddwatcher:latest
    container_name: polyoddwatcher
    ports:
      - "7770:7770"
    volumes:
      - ./poly_data:/app/data
    restart: unless-stopped
    environment:
      - TZ=America/Mexico_City

Then run:

docker compose up -d

Open your browser at:

http://localhost:7770

---

⚙️ First-Time Configuration

On the first run, PolyOddWatcher starts in Setup Mode.

1. Open http://localhost:7770
2. Enter your Telegram Bot Token
3. Enter your Telegram Chat ID
4. Configure monitoring thresholds (scan scope, spike threshold, etc.)
5. Click Save Configuration

The app will automatically reload into Live Monitoring Mode.

---

🔒 Privacy & Philosophy

• ✅ Fully self-hosted
• ✅ No cloud services
• ✅ No tracking
• ✅ Your data stays on your machine

PolyOddWatcher is designed to be transparent, inspectable, and automation-friendly.

---

🧩 Roadmap

• TBD

---

🛠️ Tech Stack

• Python 3.11
• Streamlit
• SQLite
• Docker

---

⚠️ Disclaimer

PolyOddWatcher is a monitoring and alerting tool. It does not provide financial or betting advice.

Use responsibly.

---

👤 Author & Development Philosophy

Built with ❤️ by Sgdva.

This project was developed using a vibe-coding / AI-assisted workflow: fast iteration, human-led architectural decisions, and continuous validation.

AI tools were used as accelerators — not decision-makers. All core logic, architecture, and runtime behavior were reviewed, tested, and are fully owned by the author.

If you can read it, run it, and inspect it — it belongs to you as much as to me.

---

💖 Support the Project

If PolyOddWatcher saves you time, helps you spot signals, or fits into your workflow, consider supporting its development.

• 💳 PayPal
• If this project helped you, you can buy me a coffee :)

🪙 Crypto Donations

If you’d like to support PolyOddWatcher using crypto, please double-check the network and details before sending.

XRP (Ripple)

Address:
rUcPodpLjJpsKrJAm982t7VK6dXNXyGM3g

Destination Tag: 3842476748

⚠️ Important: XRP transactions require the destination tag.
Sending XRP without the correct tag may result in lost funds.

---

📜 License

This project is released under the MIT License.

You are free to use, modify, and distribute this software, provided that proper attribution is given to the original author.