Skip to main content
skill CX Codex

polymarket-monitor — Claude Code skill: Polymarket price alerts

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

no license 220 installs ★ 100 updated 2026-02-26

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add mjunaidca/polymarket-skills --skill polymarket-monitor -a claude-code
Open on GitHub

What polymarket-monitor 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.

What it helps with

  • 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 for the agent

  • 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

How to install polymarket-monitor

1Skills CLI (Vercel)

npx skills add mjunaidca/polymarket-skills --skill polymarket-monitor -a claude-code

2Manually: put the files in place

~/.claude/skills/polymarket-monitor/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/polymarket-monitor/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about polymarket-monitor

How do I install polymarket-monitor in Claude Code?

Run npx skills add mjunaidca/polymarket-skills --skill polymarket-monitor -a claude-code. The skill file lands at ~/.claude/skills/polymarket-monitor/SKILL.md.

What does polymarket-monitor do?

It polls Polymarket markets on an interval and prints JSON alerts when price, spread or volume moves. For a single token it emits order book snapshots.

Does it need an API key?

No, every endpoint is read-only. It does need token IDs from the polymarket-scanner skill and a Python venv.

Similar skills

All skills for Finance and business →

From the same set6

Project sponsors

Companies that keep this analytics open