A high-performance terminal interface for real-time monitoring of Polymarket prediction markets, synchronized with live prices from Binance.
Ensure you have uv installed. Then, synchronize dependencies and set up the environment:
uv syncTo start the CLI monitor, simply run:
python main.pyFollow these steps to configure your monitoring session:
- Select Category: When prompted, enter
1for the Crypto category (currently the only supported domain). - Get Event URL: Go to Polymarket and navigate to the Cryptocurrency section.
[!IMPORTANT]
Only the Cryptocurrency category is supported. Ensure your URL looks like:
https://polymarket.com/event/will-bitcoin-hit-100k-in-2024 - Enter Symbol: Specify the cryptocurrency symbol you want to track against the market (e.g.,
BTC,ETH). This will pull live price data from Binance. - Select Market: If the event contains multiple markets (e.g., different price targets), the CLI will list them. Enter the corresponding number to start monitoring.
The CLI provides a "glass-morphism" inspired terminal view that updates in real-time:
- Dual WebSocket Streams: Connects simultaneously to Polymarket CLOB and Binance for sub-millisecond updates.
- Order Book Tracking: Displays the latest Bid and Ask prices for both YES and NO outcomes.
- Live Price Overlay: Monitors the underlying asset price (e.g., BTC/USDT) directly in the UI.
- Dynamic Fee Calculation: Automatically calculates and displays potential trading fees based on real-time market state.
- Flicker-Free Interface: Uses a high-speed refresh loop to ensure the terminal remains readable and responsive.
- Python 3.10+
uvPackage Manager- Active Internet Connection