A comprehensive CLI tool for tracking Polymarket prediction markets, monitoring price momentum, and simulating trades via a local paper trading system.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install polymarketodds
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 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 Prediction Market Tool?
The Polymarket skill is a robust integration designed for Openclaw Skills that allows developers and researchers to query decentralized prediction markets directly from their terminal. It provides real-time access to market odds, trending events, and volume data across diverse categories like politics, crypto, and technology. By leveraging the public Gamma API, this tool enables users to stay informed on global sentiment and market-driven forecasts without the need for complex web interfaces or account authentication.
Beyond simple data retrieval, this skill offers a suite of monitoring features tailored for power users. It allows for the tracking of specific market movements, the configuration of price-point alerts, and the maintenance of a local watchlist. It also includes a unique paper trading environment, enabling users to test their predictive accuracy with a simulated $10,000 balance, making it an essential resource for understanding market dynamics within the Openclaw Skills ecosystem.
Polymarket Prediction Market Tool Use Cases
- Monitoring political election odds and high-profile event forecasts in real-time.
- Setting automated price alerts for specific market outcomes to trigger custom notification workflows.
- Generating daily or weekly digests of trending topics in the crypto, tech, and business sectors.
- Practicing prediction strategies using the built-in paper trading simulator to track P&L without financial risk.
- Tracking upcoming market resolutions using the calendar feature to stay ahead of event outcomes.
How Polymarket Prediction Market Tool Works
- The skill interfaces with the public Polymarket Gamma API to fetch real-time market data through unauthenticated HTTPS requests.
- Users execute various CLI commands to search for events, view featured markets, or analyze price momentum over specific timeframes (24h, 1w, 1m).
- Local configuration files stored in the user directory manage persistence for watchlists and simulated portfolios.
- Scheduled cron jobs can be configured to check for alerts or generate periodic market summaries automatically.
- The paper trading engine calculates simulated profit and loss based on live market prices fetched during execution, maintaining a local history of trades.
Polymarket Prediction Market Tool Setup
Ensure you have python3 installed on your system. This skill is part of the Openclaw Skills collection and does not require any API keys or wallet connections for operation.
# Navigate to your local installation and test the connection
python3 scripts/polymarket.py trending
# Add a market to your watchlist to start tracking
python3 scripts/polymarket.py watch add trump-2028 --alert-at 60
Polymarket Prediction Market Tool Data Schema & Taxonomy
The skill manages its state locally to ensure data privacy and persistence within the Openclaw Skills environment. All data is stored in the ~/.polymarket/ directory.
| File | Description |
|---|---|
watchlist.json |
Contains the list of watched markets, specific outcomes, and user-defined alert thresholds. |
portfolio.json |
Stores paper trading data, including current positions, trade history, and simulated cash balance. |
Market data returned by the skill includes current odds (Yes/No prices), price momentum indicators, total volume, bid/ask spreads, and time remaining until resolution.
Polymarket Prediction Market Tool Advanced Features
- Momentum Scanner: Identify the biggest market movers over 24-hour, weekly, or monthly timeframes with volume filtering.
- Custom Watchlist Alerts: Set specific price targets or percentage-change triggers to stay informed of volatility.
- Category Digests: Automatically summarize the top markets in specific niches like politics or sports.
- Resolution Calendar: View a timeline of markets resolving in the near future to manage tracking priorities.
- Paper Trading Engine: A risk-free simulation starting with $10,000 to track predictive accuracy and portfolio growth.
- Cron-Ready Output: Use the --quiet flag for automated alerts, ensuring output is only generated when a threshold is met.
SKILL.md
Loading
Related Openclaw Skills
Parallel.ai Search & Research
A high-accuracy web search API optimized for AI agents to perform deep research with rich excerpts and citations.
markdown-new
Transform public web content into clean, LLM-ready Markdown for efficient AI data ingestion and processing.
Manus AI Agent
An autonomous AI agent skill that executes complex tasks through web browsing and tool usage via the Manus API.
clawdex
A high-performance CLI tool for executing and simulating token trades on the Solana blockchain via the Jupiter aggregator.
Supabase
A powerful integration for querying Supabase projects and generating user analytics directly from your chat interface.
Adaptive Routing
A local-first routing engine that prioritizes privacy and cost-efficiency by intelligently escalating LLM requests to the cloud only when necessary.
METADATA
Featured*
