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
npx skills add mjunaidca/polymarket-skills --skill polymarket-monitor -a claude-codeWhat 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.pyevery 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-code2Manually: put the files in place
~/.claude/skills/polymarket-monitor/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/polymarket-monitor/
1Skills CLI (Vercel)
npx skills add mjunaidca/polymarket-skills --skill polymarket-monitor -a codex2Manually: put the files in place
.agents/skills/polymarket-monitor/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add mjunaidca/polymarket-skills --skill polymarket-monitor -a cursor2Manually: put the files in place
.cursor/skills/polymarket-monitor/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install mjunaidca/polymarket-skills polymarket-monitor2Manually: put the files in place
.github/skills/polymarket-monitor/SKILL.md1Skills CLI (Vercel)
npx skills add mjunaidca/polymarket-skills --skill polymarket-monitor -a gemini-cli2Platform CLI
gemini skills install https://github.com/mjunaidca/polymarket-skills --path polymarket-monitorManually: put the files in place
.devin/skills/polymarket-monitor/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add mjunaidca/polymarket-skills --skill polymarket-monitor -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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.