# Better Polymarket

> Query Polymarket prediction markets - check odds, trending markets, search events, track prices, list markets by volume.

- Skill: `kbarbel640-del/better-polymarket` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add kbarbel640-del/better-polymarket`
- Raw SKILL.md: https://api.skillmd.com/api/skills/kbarbel640-del/better-polymarket/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: kbarbel640-del (https://skillmd.com/u/kbarbel640-del)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/kbarbel640-del/better-polymarket

---


# Better Polymarket

Query [Polymarket](https://polymarket.com) prediction markets. Check odds, find trending markets, search events, get single market/event by slug, list active markets by volume (aligned with Gamma API usage as in PolyEdge).

## Commands

```bash
# Trending/active events (by 24h volume)
python3 {baseDir}/scripts/polymarket.py trending

# Search markets
python3 {baseDir}/scripts/polymarket.py search "trump"
python3 {baseDir}/scripts/polymarket.py search "bitcoin"

# Get specific event by slug (event = group of markets)
python3 {baseDir}/scripts/polymarket.py event "fed-decision-in-october"

# Get single market by slug (one binary market; polymarket.com/market/xxx)
python3 {baseDir}/scripts/polymarket.py market "will-trump-win-2024"

# List active markets (by volume; like PolyEdge FetchMarkets)
python3 {baseDir}/scripts/polymarket.py markets
python3 {baseDir}/scripts/polymarket.py markets --closed   # include closed markets
python3 {baseDir}/scripts/polymarket.py markets --order volumeNum --limit 10

# Get markets by category
python3 {baseDir}/scripts/polymarket.py category politics
python3 {baseDir}/scripts/polymarket.py category crypto
python3 {baseDir}/scripts/polymarket.py category sports
```

## Example Chat Usage

- "What are the odds Trump wins 2028?"
- "Trending on Polymarket?"
- "Search Polymarket for Bitcoin"
- "What's the spread on the Fed rate decision?"
- "Any interesting crypto markets?"
- "Show me Polymarket market by slug will-trump-win-2024"
- "List top active markets by volume on Polymarket"

## Output

- **Events**: title, total volume, list of markets with Yes price, event link.
- **Markets**: question, Yes/No prices, volume, end date, resolution source when present, market link.
- **markets** command: same as single market format, ordered by volume (or specified order).

## API

Uses the public Gamma API (no auth required for reading), same surface as PolyEdge:
- Base URL: `https://gamma-api.polymarket.com`
- Endpoints: `/events`, `/events/slug/:slug`, `/markets`, `/markets/slug/:slug`, `/search`
- Params: `limit`, `offset`, `order`, `ascending`, `closed`, `active`
- Docs: https://docs.polymarket.com

## Note

This is read-only. Trading requires wallet authentication (not implemented).