polymarket-scanner — Claude Code skill: use and install
polymarket-scanner searches Polymarket markets and returns prices, volume, liquidity, and order books. Use it when an agent needs current prediction-market data.
no license 236 installs ★ 100 updated 2026-02-26
npx skills add mjunaidca/polymarket-skills --skill polymarket-scanner -a claude-codeWhat polymarket-scanner does
This skill scans active Polymarket markets with scan_markets.py. The script can narrow results by category, keyword, or minimum volume, then order them by volume, liquidity, or date. Each market record can include the question, outcomes, prices, token IDs, spread, trading totals, liquidity, and end date.
The three scripts share token IDs. Start with scan_markets.py, pass the returned IDs to get_prices.py for current bids, asks, midpoints, and spreads, or use get_orderbook.py to inspect buy and sell levels. Requests are read-only, and the skill works without API keys or authentication.
The scripts rely on the Python environment at /home/verticalclaw/.venv; commands fail without that environment. Order-book queries also need a token ID obtained from a market scan, while price queries can use one or several IDs.
What it helps with
- search active markets by topic or keyword
- sort markets by volume or liquidity
- retrieve current token prices and spreads
- inspect bids, asks, and market depth
- connect a market to its token IDs
Example prompts for the agent
- Scan Polymarket for active
cryptomarkets and return the 10 highest-volume results. - Search for markets containing
trump, then show their prices, volume, and token IDs. - Read the order book for
<TOKEN_ID>and compare the best bid with the best ask.
How to install polymarket-scanner
1Skills CLI (Vercel)
npx skills add mjunaidca/polymarket-skills --skill polymarket-scanner -a claude-code2Manually: put the files in place
~/.claude/skills/polymarket-scanner/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/polymarket-scanner/
1Skills CLI (Vercel)
npx skills add mjunaidca/polymarket-skills --skill polymarket-scanner -a codex2Manually: put the files in place
.agents/skills/polymarket-scanner/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add mjunaidca/polymarket-skills --skill polymarket-scanner -a cursor2Manually: put the files in place
.cursor/skills/polymarket-scanner/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install mjunaidca/polymarket-skills polymarket-scanner2Manually: put the files in place
.github/skills/polymarket-scanner/SKILL.md1Skills CLI (Vercel)
npx skills add mjunaidca/polymarket-skills --skill polymarket-scanner -a gemini-cli2Platform CLI
gemini skills install https://github.com/mjunaidca/polymarket-skills --path polymarket-scannerManually: put the files in place
.devin/skills/polymarket-scanner/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add mjunaidca/polymarket-skills --skill polymarket-scanner -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-scanner
How do I install polymarket-scanner in Claude Code?
Run npx skills add mjunaidca/polymarket-skills --skill polymarket-scanner -a claude-code. The installed skill is then available at ~/.claude/skills/polymarket-scanner/SKILL.md.
What does polymarket-scanner do?
It searches Polymarket markets and returns market questions, outcomes, prices, volume, liquidity, and dates. It can then fetch live token prices or a full order book.
What does the skill need to run?
Its scripts use the Python environment at /home/verticalclaw/.venv. No API key or authentication is required, but an order-book lookup needs a token ID.