txbabaxyz/polyalert

PolyAlert is a Telegram bot that watches Polymarket, an online prediction market where people buy and sell shares tied to real-world event outcomes (like "Will X happen by date Y?"). The bot sends you a notification when a price you care about crosses a level you set, for example, alerting you when the "YES" price on a question goes above 0.55. Polymarket's own website has no built-in alerts, and other third-party alert tools either charge money or check prices only every few seconds or minutes, PolyAlert connects directly to Polymarket's real-time data stream, so it reacts the moment a price moves. Setting up an alert is a guided chat conversation: you paste a Polymarket event link, choose which outcome to watch (YES, NO, or one of many outcomes in multi-option events), pick which price side to track (bid, ask, or midpoint), choose whether to fire above or below your number, and type the threshold. Once the live price crosses that line, the alert fires once and then deletes itself, no repeat notifications. Each Telegram user gets their own private set of alerts, with up to 10 active at a time by default. Under the hood, all alerts share a single WebSocket connection to Polymarket's live price feed, which makes the system efficient. Alerts and user data are stored in an SQLite database. The bot is written in Python 3.12 using asyncio for concurrency, aiogram 3 for the Telegram interface, aiosqlite for the database, and the websockets library for the live price connection. It is designed to run on a Linux server under systemd and includes daily database backup support.