polymarket-opportunities-scanning

What This Skill Does

The polymarket-opportunities-scanning skill allows OpenClaw to perform automated quantitative analysis on the Polymarket prediction market platform. It scans active multi-outcome markets to identify arbitrage opportunities—specifically situations where the sum of probabilities for mutually exclusive outcomes deviates significantly from 1.0. The agent categorizes these as either 'OVERBOOK' (sum > 1.0) or 'UNDERBOOK' (sum < 1.0) and provides a clear strategy for the user to profit from the price discrepancy. It includes logic to prioritize 'NegRisk' markets, which offer the highest structural reliability for these trades. The skill is designed for hands-off operation, including a reporting engine that delivers findings via Telegram or local macOS email automation.

Installation

1. Ensure you have Node.js installed on your system.
2. Install the skill via terminal: clawhub install openclaw/skills/skills/caoqi/polymarket-opportunities-scanning.
3. Navigate to the installation directory and create a .env file based on the reference documentation to define your communication preferences (Telegram ID and email settings).
4. Run the test script node scanner.js && node send-report.js to ensure environmental variables are properly parsed.
5. Optionally, configure a cron job to automate daily scans at your preferred time using the provided JSON task schema.

Use Cases

• Automated Arbitrage: Maintain a competitive edge by identifying mispriced markets as soon as they manifest.
• Market Monitoring: Stay informed on high-volume prediction trends without manually refreshing websites.
• Daily Briefings: Receive a consolidated morning report on market health and potential volatility before the market day begins.

Example Prompts

• "Scan Polymarket for any current arbitrage opportunities in high-volume markets."
• "Run the Polymarket report and send it to my Telegram account now."
• "Set up a daily morning report to check for Polymarket arb opportunities."

Tips & Limitations

• Configurable Thresholds: Users should adjust minVolume and minThreshold inside scanner.js to match their risk tolerance; tightening these will reduce noise, while loosening them will surface more (though potentially riskier) opportunities.
• OS Limitations: The email delivery feature currently relies on macOS osascript integration.
• Market Volatility: Always cross-reference the report with the official Polymarket site, as prices in liquid markets can change within seconds of a scan completing.