pwatch

Cryptocurrency futures price monitor with Telegram alerts.

Install

uv tool install git+https://github.com/Xeron2000/pwatch

Usage

pwatch                                         # Start monitoring
pwatch update-markets                          # Update market data
pwatch update-markets --exchanges okx binance  # Update specific exchanges
pwatch config-path                             # Show config directory

First run guides you through setup — you'll need a Telegram Bot Token.

Config

Located at ~/.config/pwatch/config.yaml:

exchange: "okx"
defaultTimeframe: "5m"
checkInterval: "1m"
defaultThreshold: 1
notificationSymbols: "auto"  # top 50 by volume, refreshes every 4h

telegram:
  token: "your-bot-token"
  chatId: "your-chat-id"

License

MIT