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