polymarket

Overview
The Polymarket skill lets AI agents interact with Polymarket prediction markets directly from the command line. It provides real-time access to market odds, trending events, price movements, and upcoming resolutions. With built-in watchlists, alerts, and paper trading, agents can monitor markets, simulate trades, and receive notifications — all without manual browsing.

Key Features

• Market Discovery: Search markets, browse by category, and view featured or trending events.
• Watchlists & Alerts: Track specific markets with price or percentage-change triggers; get cron-compatible alerts.
• Momentum Scanner: Identify the biggest movers over configurable timeframes with volume filters.
• Resolution Calendar: See markets resolving soon (e.g., next 7 days).
• Paper Trading: Simulate buying and selling positions to track portfolio P&L.

How It Works
The skill uses a Python script (polymarket.py) that queries the public Polymarket API for market data. All commands are run via python3 {baseDir}/scripts/polymarket.py <action> [options]. Results are returned as formatted text for easy parsing by the agent. Watchlists and paper trades are stored locally, and alerts can be configured for cron-based checks.

Use Cases

• Daily Briefing: Include trending markets and top movers in a morning report.
• Event Monitoring: Watch a specific prediction (e.g., “Trump 2028”) and get alerted when odds cross a target.
• Paper Trading: Test strategies by simulated betting without risking real money.