Polymarket

Polymarket

Query [Polymarket](https://polymarket.com) prediction markets. Check odds, find trending markets, search events, track price movements.

Quick Start

Trending markets
python3 {baseDir}/scripts/polymarket.py trending

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

Biggest movers
python3 {baseDir}/scripts/polymarket.py movers

What's resolving soon
python3 {baseDir}/scripts/polymarket.py calendar

---

After Install — Suggested Setup

1. Add to Morning Briefing

Add Polymarket to your daily cron:

polymarket featured + polymarket movers --timeframe 24h

2. Watch Markets You Care About

Watch with price target alert
python3 {baseDir}/scripts/polymarket.py watch add trump-2028 --alert-at 60

Watch with change alert (±10% from current)
python3 {baseDir}/scripts/polymarket.py watch add bitcoin-100k --alert-change 10

3. Set Up Hourly Alerts (Cron)

Check watchlist every hour, only notify on alerts
python3 {baseDir}/scripts/polymarket.py alerts --quiet

4. Weekly Category Digests

Every Sunday: politics digest
python3 {baseDir}/scripts/polymarket.py digest politics

5. Paper Trade to Track Predictions

python3 {baseDir}/scripts/polymarket.py buy trump-2028 100  # $100 on Trump
python3 {baseDir}/scripts/polymarket.py portfolio           # Check P&L

---

Commands

Core

Trending markets (by 24h volume)
python3 {baseDir}/scripts/polymarket.py trending

Featured/high-profile markets
python3 {baseDir}/scripts/polymarket.py featured

Search markets
python3 {baseDir}/scripts/polymarket.py search "giannis"

Get event by slug
python3 {baseDir}/scripts/polymarket.py event trump-2028

Browse by category
python3 {baseDir}/scripts/polymarket.py category politics

Watchlist + Alerts (NEW)

Add to watchlist
python3 {baseDir}/scripts/polymarket.py watch add trump-2028
python3 {baseDir}/scripts/polymarket.py watch add bitcoin-100k --alert-at 70
python3 {baseDir}/scripts/polymarket.py watch add fed-rate-cut --alert-change 15

Watch specific outcome in multi-market
python3 {baseDir}/scripts/polymarket.py watch add giannis-trade --outcome warriors

List watchlist with current prices
python3 {baseDir}/scripts/polymarket.py watch list

Remove from watchlist
python3 {baseDir}/scripts/polymarket.py watch remove trump-2028

Check for alerts (for cron)
python3 {baseDir}/scripts/polymarket.py alerts
python3 {baseDir}/scripts/polymarket.py alerts --quiet  # Only output if triggered

Resolution Calendar (NEW)

Markets resolving in next 7 days
python3 {baseDir}/scripts/polymarket.py calendar

Markets resolving in next 3 days
python3 {baseDir}/scripts/polymarket.py calendar --days 3

More results
python3 {baseDir}/scripts/polymarket.py calendar --days 14 --limit 20

Momentum Scanner (NEW)

Biggest movers (24h)
python3 {baseDir}/scripts/polymarket.py movers

Weekly movers
python3 {baseDir}/scripts/polymarket.py movers --timeframe 1w

Monthly movers with volume filter
python3 {baseDir}/scripts/polymarket.py movers --timeframe 1m --min-volume 50

Category Digests (NEW)

Politics digest
python3 {baseDir}/scripts/polymarket.py digest politics

Crypto digest
python3 {baseDir}/scripts/polymarket.py digest crypto

Sports digest
python3 {baseDir}/scripts/polymarket.py digest sports

Categories: politics, crypto, sports, tech, business

Paper Trading (NEW)

Buy $100 of a market
python3 {baseDir}/scripts/polymarket.py buy trump-2028 100

Buy specific outcome
python3 {baseDir}/scripts/polymarket.py buy giannis-trade 50 --outcome warriors

View portfolio
python3 {baseDir}/scripts/polymarket.py portfolio

Sell position
python3 {baseDir}/scripts/polymarket.py sell trump-2028

Starts with $10,000 paper cash. Track your predictions without real money.

---

Data Storage

Watchlist and portfolio stored in ~/.polymarket/:

• -watchlist.json — Watched markets and alert thresholds
• -portfolio.json — Paper positions and trade history

---

Cron Examples

Hourly Alert Check

0 * * * * python3 ~/.../polymarket.py alerts --quiet

Daily Morning Brief

0 7 * * * python3 ~/.../polymarket.py movers && python3 ~/.../polymarket.py calendar --days 1

Weekly Digests

0 10 * * 0 python3 ~/.../polymarket.py digest politics
0 10 * * 0 python3 ~/.../polymarket.py digest crypto

---

Output Features

Markets show:

• -Current odds (Yes/No prices)
• -Price momentum (24h/1wk/1mo changes with arrows)
• -Volume (total + 24h activity)
• -Time remaining
• -Bid/ask spread

---

API

Uses the public Gamma API (no auth required for reading):

• -Base URL: https://gamma-api.polymarket.com
• -Docs: https://docs.polymarket.com

---

Security & Permissions

No API key or authentication required. This skill uses Polymarket's public Gamma API. What this skill does:

• -Makes HTTPS GET requests to gamma-api.polymarket.com (public, unauthenticated)
• -Reads market data: odds, volumes, event details, price history
• -Paper trading is local simulation only — stored in ~/.polymarket/ as JSON files
• -No real money, no wallet, no blockchain transactions

What this skill does NOT do:

• -Does not connect to any wallet or financial account
• -Does not execute real trades or transactions
• -Does not require or handle any credentials or API keys
• -Does not send any personal data externally
• -Cannot be invoked autonomously by the agent (disable-model-invocation: true)

Data stored locally: ~/.polymarket/watchlist.json, ~/.polymarket/portfolio.json

Review scripts/polymarket.py before first use to verify behavior.

Note

This is read-only + paper trading. Real trading requires wallet authentication (not implemented).