Polymarketskill

Query Polymarket prediction markets - check odds, trending markets, search events, track prices and momentum. Includes watchlist alerts, resolution calendar,...

Security Scan

The skill's code, instructions, and requirements are consistent with a Polymarket CLI/watchlist tool; it talks only to Polymarket's API and stores data under ~/.polymarket, and it does not request unrelated credentials or configure system-wide privileges.

Purpose & Capability

Name/description match the implementation: the script queries Polymarket's Gamma API (BASE_URL = https://gamma-api.polymarket.com), provides searching, trending, movers, calendar, watchlist, alerts, and paper-trading functionality as described. Required binary (python3) and use of the requests library are proportionate to the stated purpose.

Instruction Scope

SKILL.md instructions stay within the stated scope: they run the included CLI, schedule cron jobs, and store watchlist/portfolio locally. There are no instructions to read unrelated system files or exfiltrate data to third parties. The README encourages cron usage (user-controlled) but does not grant the skill autonomous execution.

Install Mechanism

This is instruction-only (no install spec). The Python script includes a dependencies comment (requests>=2.28.0) but the skill does not install it automatically, so the user must ensure python and requests are present. No downloads from untrusted URLs or archive extracts are present.

Credentials

The skill requests no environment variables, no credentials, and no config paths. All persistent data is stored under the user's home at ~/.polymarket, which is appropriate for watchlist/portfolio storage.

Persistence & Privilege

The skill is not always-enabled, is user-invocable, and sets disable-model-invocation=true (so it cannot be invoked autonomously by the model). It writes only to its own per-user data directory (~/.polymarket) and does not attempt to modify other skills or system-wide agent settings.

Assessment

This skill appears to be a straightforward Polymarket CLI. Before installing: (1) review the script yourself (it will be executed locally) and confirm BASE_URL is expected (gamma-api.polymarket.com); (2) run it in a Python virtualenv and install the requests package rather than system-wide if you prefer isolation; (3) be aware it writes watchlist.json and portfolio.json under ~/.polymarket—backup or inspect those files if you care about local storage; (4) cron examples in the README will run the script periodically only if you add them — the skill will not schedule cron jobs by itself; (5) if you need higher assurance, inspect the full script for any additional network endpoints or unexpected behavior before adding it to automated jobs.

Polymarket

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

python3 {baseDir}/scripts/polymarket.py featured
python3 {baseDir}/scripts/polymarket.py 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 or URL
python3 {baseDir}/scripts/polymarket.py event trump-2028
python3 {baseDir}/scripts/polymarket.py event https://polymarket.com/event/trump-2028

# Show all outcomes in an event
python3 {baseDir}/scripts/polymarket.py event trump-2028 --all

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

# Limit results
python3 {baseDir}/scripts/polymarket.py trending --limit 10

Watchlist + Alerts

# 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 a specific outcome in a multi-market event
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

# Remove a specific outcome entry
python3 {baseDir}/scripts/polymarket.py watch remove giannis-trade --outcome warriors

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

Resolution Calendar

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

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

# More results over a longer window
python3 {baseDir}/scripts/polymarket.py calendar --days 14 --limit 20

Momentum Scanner

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

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

# Monthly movers with volume filter ($50K+ 24h volume)
python3 {baseDir}/scripts/polymarket.py movers --timeframe 1m --min-volume 50

Timeframes: 24h (default), 1w, 1m

Category Digests

# 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

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

# Buy $100 of a market (Yes outcome)
python3 {baseDir}/scripts/polymarket.py buy trump-2028 100

# Buy a specific outcome in a multi-market event
python3 {baseDir}/scripts/polymarket.py buy giannis-trade 50 --outcome warriors

# View portfolio and P&L
python3 {baseDir}/scripts/polymarket.py portfolio

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

# Sell a specific outcome
python3 {baseDir}/scripts/polymarket.py sell giannis-trade --outcome warriors

# Reset portfolio back to $10,000 (clears all positions)
python3 {baseDir}/scripts/polymarket.py reset

---

Global Flags

Flag	Short	Description
--limit N	-l	Number of results to show (default: 5)
--all	-a	Show all outcomes/markets in an event

These flags work with: trending, featured, search, category, calendar, movers, digest, and event.

---

Data Storage

Watchlist and portfolio are stored locally in ~/.polymarket/:

File	Contents
watchlist.json	Watched markets and alert thresholds
portfolio.json	Paper positions and trade history

---

Cron Examples

Hourly Alert Check

0 * * * * python3 {baseDir}/scripts/polymarket.py alerts --quiet

Daily Morning Brief

0 7 * * * python3 {baseDir}/scripts/polymarket.py movers && python3 {baseDir}/scripts/polymarket.py calendar --days 1

Weekly Digests

0 10 * * 0 python3 {baseDir}/scripts/polymarket.py digest politics
0 10 * * 0 python3 {baseDir}/scripts/polymarket.py digest crypto

---

Output Features

Markets display:

• Current odds — Yes/No prices as percentages
• Price momentum — 24h/1w/1m changes with directional arrows
• Volume — total and 24h activity
• Time remaining — until market resolution
• Bid/ask spread — where available

---

API

Uses the public Gamma API (no authentication required):

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

Bulk commands (watch list, alerts, portfolio) are rate-limited to 1 request per 250ms to avoid hammering the API.

---

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 market data + local paper trading only. Real trading on Polymarket requires wallet authentication, which is not implemented in this skill.