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).
1---2name: better-polymarket3description: Query Polymarket prediction markets - check odds, trending markets, search events, track prices, list markets by volume.4---5
6# Better Polymarket
7
8Query [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).
9
10## Commands
11
12```bash
13# Trending/active events (by 24h volume)
14python3 {baseDir}/scripts/polymarket.py trending
15
16# Search markets
17python3 {baseDir}/scripts/polymarket.py search "trump"
18python3 {baseDir}/scripts/polymarket.py search "bitcoin"
19
20# Get specific event by slug (event = group of markets)
21python3 {baseDir}/scripts/polymarket.py event "fed-decision-in-october"
22
23# Get single market by slug (one binary market; polymarket.com/market/xxx)
24python3 {baseDir}/scripts/polymarket.py market "will-trump-win-2024"
25
26# List active markets (by volume; like PolyEdge FetchMarkets)
27python3 {baseDir}/scripts/polymarket.py markets
28python3 {baseDir}/scripts/polymarket.py markets --closed # include closed markets
29python3 {baseDir}/scripts/polymarket.py markets --order volumeNum --limit 10
30
31# Get markets by category
32python3 {baseDir}/scripts/polymarket.py category politics
33python3 {baseDir}/scripts/polymarket.py category crypto
34python3 {baseDir}/scripts/polymarket.py category sports
35```
36
37## Example Chat Usage
38
39- "What are the odds Trump wins 2028?"
40- "Trending on Polymarket?"
41- "Search Polymarket for Bitcoin"
42- "What's the spread on the Fed rate decision?"
43- "Any interesting crypto markets?"
44- "Show me Polymarket market by slug will-trump-win-2024"
45- "List top active markets by volume on Polymarket"
46
47## Output
48
49- **Events**: title, total volume, list of markets with Yes price, event link.
50- **Markets**: question, Yes/No prices, volume, end date, resolution source when present, market link.
51- **markets** command: same as single market format, ordered by volume (or specified order).
52
53## API
54
55Uses the public Gamma API (no auth required for reading), same surface as PolyEdge:
56- Base URL: `https://gamma-api.polymarket.com`
57- Endpoints: `/events`, `/events/slug/:slug`, `/markets`, `/markets/slug/:slug`, `/search`
58- Params: `limit`, `offset`, `order`, `ascending`, `closed`, `active`
59- Docs: https://docs.polymarket.com
60
61## Note
62
63This is read-only. Trading requires wallet authentication (not implemented).