A comprehensive CLI toolkit for querying Polymarket prediction data, tracking market momentum, and simulated paper trading.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install polymarketodds-1-0-0
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install polymarketodds-1-0-0 using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Polymarket?
The Polymarket skill is a powerful data-driven integration designed for analysts and developers who want to leverage real-time prediction market insights. By connecting directly to the public Gamma API, this tool allows users to monitor global sentiment on everything from political elections to crypto trends. As part of the Openclaw Skills ecosystem, it provides a seamless way to integrate market probabilities into your automated workflows or daily terminal usage.
Beyond simple data fetching, this skill features a robust local simulation engine. Users can practice prediction strategies through a built-in paper trading system that tracks P&L without any real-world financial risk. It is an essential utility for anyone looking to quantify future events using decentralized market data.
Polymarket Use Cases
- Monitoring real-time odds for political elections and global news events.
- Tracking market sentiment for crypto price movements and tech milestones.
- Setting up automated price alerts for specific prediction outcomes.
- Simulating trading strategies using a virtual $10,000 paper trading balance.
- Generating automated weekly digests for specific market categories like sports or business.
How Polymarket Works
- The skill interacts with the Polymarket Gamma API to retrieve live market data, including current odds, volume, and bid/ask spreads.
- Users execute CLI commands to search for specific markets or filter trending events by 24-hour volume.
- A local momentum scanner analyzes price changes across multiple timeframes (24h, 1w, 1m) to identify significant shifts in market sentiment.
- The watchlist system stores user-defined price targets in a local JSON file and evaluates them during manual or automated checks.
- Paper trading actions are recorded locally, allowing for a persistent simulated portfolio that tracks gains and losses over time.
Polymarket Setup
This skill requires Python 3 and does not require any API keys or wallet authentication for read-only access. To get started with Openclaw Skills for Polymarket, ensure the script is executable in your environment.
# Check trending markets to verify installation
python3 scripts/polymarket.py trending
# Search for a specific market
python3 scripts/polymarket.py search "bitcoin"
To enable automated alerts, you can add a cron job:
0 * * * * python3 scripts/polymarket.py alerts --quiet
Polymarket Data Schema & Taxonomy
The skill maintains local state within the ~/.polymarket/ directory to ensure fast access and privacy. This is a key feature of Openclaw Skills that focus on local-first data management.
| File | Purpose |
|---|---|
watchlist.json |
Stores tracked market slugs, outcome preferences, and alert thresholds (at-price or % change). |
portfolio.json |
Manages the paper trading ledger, including current positions, trade history, and virtual cash balance. |
Market data returned by the API is processed to display:
- Yes/No prices and spreads
- Volume (Total and 24h activity)
- Time remaining until resolution
- Price momentum indicators
Polymarket Advanced Features
- Momentum Scanner: Identify the biggest movers across various timeframes with configurable volume filters.
- Resolution Calendar: Track which markets are set to resolve in the coming days to manage your watchlist effectively.
- Paper Trading Engine: Start with a virtual $10,000 and execute buy/sell orders for specific market outcomes.
- Category Digests: Generate concise summaries for specific sectors like politics, tech, or crypto.
- Automated Monitoring: Integration-ready commands for cron jobs to provide daily morning briefs or hourly alerts.
SKILL.md
Loading
Related Openclaw Skills
Playwright Scraper Skill
A high-performance web scraping tool powered by Playwright, specifically engineered to bypass Cloudflare and sophisticated anti-bot protections.
Playwright MCP
A high-performance browser automation skill that enables AI agents to control web browsers, navigate sites, and interact with elements via the Model Context Protocol.
n8n Workflow Automation
A specialized skill for designing production-grade n8n workflows featuring built-in error handling, idempotency, and comprehensive audit logging.
Elite Longterm Memory
A robust multi-layer memory architecture for AI agents that ensures persistent context across sessions using vector search, git-notes, and a Write-Ahead Log protocol.
Tandoor Recipes
A powerful integration for Openclaw Skills that enables AI agents to manage recipes, meal plans, and shopping lists within a Tandoor Recipe Manager instance.
Telegram Auto-Topic
Automatically transform any Telegram message into a new forum topic with AI-generated titles using the /topic command.
Featured*
