# polymarket-monitor

polymarket-monitor polls Polymarket markets on a timer and prints JSON alerts when a midpoint crosses your threshold, plus order book snapshots.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 220 installs · ★ 100 repo stars
- Author: polymarket-skills
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/mjunaidca/polymarket-skills/tree/HEAD/polymarket-monitor/SKILL.md
- Updated: 2026-02-26
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/polymarket-monitor

## What it does

The skill watches Polymarket order books and prints JSON alerts, one object per line. `monitor_prices.py` takes several token IDs, polls them on a timer and fires when the midpoint drifts past a percentage threshold: `--threshold` defaults to 5.0, `--interval` to 30 seconds with a floor of 5. `watch_market.py` handles a single token and emits a snapshot with best bid and ask, spread, book depth and the latest trade.

Both scripts accept `--max-polls` to stop after a fixed number of polls, which is what you want for a scripted run. `--baseline-window` averages recent prices instead of comparing against the previous poll. Endpoints are read-only, so no API key is involved.

Token IDs come from `scan_markets.py` in the `polymarket-scanner` skill, so monitoring can't start without them. Watch the venv as well: every command sources `/home/verticalclaw/.venv`, a path that won't exist on your machine — swap in your own or the script dies on activation.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add mjunaidca/polymarket-skills --skill polymarket-monitor -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/polymarket-monitor/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/polymarket-monitor/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add mjunaidca/polymarket-skills --skill polymarket-monitor -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/polymarket-monitor/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add mjunaidca/polymarket-skills --skill polymarket-monitor -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/polymarket-monitor/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install mjunaidca/polymarket-skills polymarket-monitor
```

2. **Manually: put the files in place**
- File: `.github/skills/polymarket-monitor/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add mjunaidca/polymarket-skills --skill polymarket-monitor -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/mjunaidca/polymarket-skills --path polymarket-monitor
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/polymarket-monitor/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add mjunaidca/polymarket-skills --skill polymarket-monitor -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/mjunaidca/polymarket-skills/tree/HEAD/polymarket-monitor/SKILL.md

## When to use it
- catch a midpoint move past a set percentage threshold
- watch spread and book depth on one token
- stop a monitoring run after a fixed number of polls
- compare price against a rolling average of recent polls
- feed JSON alert lines straight into an agent loop

## Example prompts
- Watch token `<TOKEN_ID>` and alert me on a 5% move
- Run `monitor_prices.py` every 30 seconds for 10 polls on these token IDs
- Print a book snapshot for `<TOKEN_ID>` every 15 seconds

## Similar
- [monitor-polymarket](https://affpapa.org/en/nevibecode/skills/monitor-polymarket.md) — skill · ★ 797 repo stars
- [nothing-ever-happens-polymarket-bot](https://affpapa.org/en/nevibecode/skills/nothing-ever-happens-polymarket-bot.md) — skill · 433 installs
- [polymarket](https://affpapa.org/en/nevibecode/skills/starchild-polymarket.md) — skill · 237 installs
- [Prediction Markets — Polymarket & Kalshi Live Odds](https://affpapa.org/en/nevibecode/mcp/prediction-markets-polymarket-kalshi-live-odds.md) — MCP server · 4215 installs
- [grimoire-polymarket](https://affpapa.org/en/nevibecode/skills/grimoire-polymarket.md) — skill · 11900 installs
- [Polymarket Data by PolymarketScan](https://affpapa.org/en/nevibecode/mcp/polymarket-data-by-polymarketscan.md) — MCP server · 39483 installs

From the same set: [mjunaidca/polymarket-skills](https://affpapa.org/en/nevibecode/by/mjunaidca/polymarket-skills.md) — 6 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
