better-polymarket

Better Polymarket

Query Polymarket 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

# 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).