# polymarket-scanner

polymarket-scanner searches Polymarket markets and returns prices, volume, liquidity, and order books. Use it when an agent needs current prediction-market data.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 236 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-scanner/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-scanner

## What it 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.

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

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

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add mjunaidca/polymarket-skills --skill polymarket-scanner -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-scanner/SKILL.md

## When to use it
- 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
- Scan Polymarket for active `crypto` markets 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.

## Similar
- [polymarket](https://affpapa.org/en/nevibecode/skills/hermes-agent-teknium-polymarket.md) — skill · 282 installs
- [nothing-ever-happens-polymarket-bot](https://affpapa.org/en/nevibecode/skills/nothing-ever-happens-polymarket-bot.md) — skill · 433 installs
- [Polymarket Data by PolymarketScan](https://affpapa.org/en/nevibecode/mcp/polymarket-data-by-polymarketscan.md) — MCP server · 39483 installs
- [PredictionMarketsPicks — NFL Props, Kalshi & Polymarket](https://affpapa.org/en/nevibecode/mcp/predictionmarketspicks-nfl-props-kalshi-polymarket.md) — MCP server · 1794 installs
- [monitor-polymarket](https://affpapa.org/en/nevibecode/skills/monitor-polymarket.md) — skill · ★ 797 repo stars
- [polymarket-toolkit](https://affpapa.org/en/nevibecode/mcp/polymarket-toolkit.md) — MCP server · ★ 204 repo stars

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
