polymarket-monitor

Original：🇺🇸 English

Translated

2 scriptsChecked / no sensitive code detected

Use this skill whenever the user wants to monitor, watch, or track Polymarket prediction market prices over time. This includes setting up price alerts, watching for significant price movements, tracking spread changes, monitoring volume spikes, or getting notified about market activity. Trigger on: monitor prices, price alert, watch market, track prices, notify me, price change, polymarket alerts, market watch, price movement, volume spike, spread monitoring, track odds, prediction market alerts, continuous monitoring, price tracker, market surveillance.

3installs

Sourcemjunaidca/polymarket-skills

Added on2026-04-09

NPX Install

npx skill4agent add mjunaidca/polymarket-skills polymarket-monitor

SKILL.md Content

View Translation Comparison →

Polymarket Monitor

Monitor live Polymarket prediction markets for price changes, volume spikes, and spread movements. Outputs structured JSON alerts when thresholds are crossed. All endpoints are read-only and require no API keys.

Prerequisite: This skill uses token IDs from the

polymarket-scanner

skill. Run

scan_markets.py

first to discover markets and obtain token IDs.

Quick Start

All scripts require the Python venv at

/home/verticalclaw/.venv

.

Monitor Multiple Markets for Price Alerts

bash

source /home/verticalclaw/.venv/bin/activate && python polymarket-monitor/scripts/monitor_prices.py \
  --token-id "<TOKEN_ID_1>" \
  --token-id "<TOKEN_ID_2>" \
  --interval 30 \
  --threshold 5.0

This polls every 30 seconds and prints a JSON alert whenever a token's midpoint moves more than 5% from its baseline.

Watch a Single Market Live

bash

source /home/verticalclaw/.venv/bin/activate && python polymarket-monitor/scripts/watch_market.py \
  --token-id "<TOKEN_ID>" \
  --interval 15

Prints a JSON snapshot every 15 seconds with price, spread, and order book depth.

Scripts

monitor_prices.py

Polls multiple tokens at a set interval and emits JSON alerts when price changes exceed a threshold.

Arguments:

```
--token-id ID
```
— CLOB token ID to monitor (repeatable, at least one required)
```
--interval N
```
— Polling interval in seconds (default: 30, minimum: 5)
```
--threshold N
```
— Percentage change to trigger an alert (default: 5.0)
```
--max-polls N
```
— Stop after N polls (default: unlimited, use for non-interactive runs)
```
--baseline-window N
```
— Number of recent prices to average for baseline (default: 1, meaning compare to last poll)

Output: One JSON object per line for each alert:

json

{
  "type": "price_alert",
  "token_id": "...",
  "timestamp": "2026-02-26T12:00:00Z",
  "current_price": 0.65,
  "baseline_price": 0.60,
  "change_pct": 8.33,
  "direction": "up",
  "spread": 0.02,
  "poll_number": 5
}

Non-alert polls print a status line to stderr so the agent knows monitoring is active.

watch_market.py

Continuously monitors a single market, printing a JSON snapshot each interval with price, spread, volume, and order book summary.