A python-powered CLI skill providing real-time data tracking, momentum scanning, and local paper trading simulations for Polymarket prediction markets.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install super-polymarket-trade
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 super-polymarket-trade 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 an analytical toolkit designed to query prediction markets directly from your command-line environment. Built to interface with public market data streams, it provides an efficient way to track trending events, examine historical odds fluctuations, and evaluate market sentiments across categories like politics, crypto, sports, tech, and business without relying on a browser interface.
By leveraging this application within Openclaw Skills, users gain automated workflows for monitoring market movements. The utility includes advanced tracking mechanics like price target triggers, periodic digests, and a self-contained paper trading engine that simulates financial positions locally without real-money exposure or wallet authentication requirements.
Polymarket Use Cases
- Automated Market Surveillance: Set automated cron tasks to flag dramatic price momentum shifts across high-profile categories.
- Risk-Free Prediction Tracking: Test forecasting theories using the built-in paper trading engine with a simulated baseline cash balance.
- Event Resolution Monitoring: Generate timeline agendas showing which prediction markets are scheduled to resolve within standard intervals.
- Data-Driven Sentiment Research: Build structured digests analyzing trading volume spikes and sentiment indicators to capture macro trends.
How Polymarket Works
- Data Retrieval: The application executes unauthenticated HTTPS GET requests to the public Polymarket Gamma API to obtain raw market telemetry, including bid/ask spreads, current odds, and active trading volumes.
- Local Assessment: Collected data is filtered against predefined criteria such as volume floors, specific categories, or designated event slugs requested via CLI flags.
- Persistence Management: Watchlists, specific alert configurations, and local paper trading ledger changes are logged locally inside JSON data stores.
- Notification Dispatch: When evaluating active alerts, the script cross-checks current API values against local conditions and outputs notifications to standard stdout channels, which can be silenced or captured via cron tasks.
Polymarket Setup
Prerequisites
Ensure python3 is installed and accessible in your system environment.
Quick Execution Syntax
Invoke the skill directly using python3 against the designated script pathways within Openclaw Skills:
# Fetch trending prediction markets sorted by 24h trading volume
python3 {baseDir}/scripts/polymarket.py trending
# Look up specific event categories or market titles
python3 {baseDir}/scripts/polymarket.py search "trump"
# Check out the highest momentum movers over the day
python3 {baseDir}/scripts/polymarket.py movers
# Display upcoming market resolutions
python3 {baseDir}/scripts/polymarket.py calendar
Polymarket Data Schema & Taxonomy
The skill manages information without requiring external databases, recording all user preferences and simulated histories locally within the user home directory at ~/.polymarket/.
| File Name | Format | Primary Purpose |
|---|---|---|
watchlist.json |
JSON Object | Tracks target markets, custom alert criteria, price target triggers, and percentage volatility boundaries. |
portfolio.json |
JSON Object | Contains local paper trading data structures, current simulated cash balance ($10,000 base), and asset histories. |
Extracted API Attributes
Returned market payloads expose the following fields:
- Current Odds: Active binary values mapping direct Yes/No prices.
- Price Momentum: Tracked percentage changes spanning 24h, 1-week, and 1-month historic benchmarks.
- Activity Volume: Cumulative total funding pool juxtaposed alongside 24h action windows.
- Market State: Remaining expiration timelines along with exact bid/ask spreads.
Polymarket Advanced Features
- Granular Price Alert Triggers: Append targeted boundaries utilizing flags like
--alert-ator--alert-changeto identify critical sentiment changes. - Comprehensive Momentum Scanner: Refine high-volatility analysis by applying multi-duration intervals and minimum volume parameters (
--timeframe 1m --min-volume 50). - Risk-Free Paper Trading Simulation: Spin up simulated market positions utilizing localized tracking storage parameters to log asset performance safely.
- Cron-Ready Pipeline Execution: Native support for silent logging routines using the
--quietflag, designed for clean cron configuration and morning briefing automation setups.
SKILL.md
Loading
Related Openclaw Skills
Group Cruise Travel Planner
An MCP skill designed to formulate customized, multi-criteria group and corporate cruise travel itineraries automatically.
Luxury Cruise Experience Recommendation (craftwave-skill-7)
An advanced MCP skill designed to recommend premium, luxury cruise experiences to high-end travelers using multi-dimensional product filtering.
Craftwave Luxury Cruise Recommendation Skill
A Model Context Protocol (MCP) server delivering high-end cruise and elite travel recommendations to AI assistants.
Unified WPS Office AI Assistant (li-wps-mod)
An advanced AI agent assistant powered by 231 MCP tools designed to fully automate, format, and manage WPS Office spreadsheets, documents, and presentations via natural language.
Self-Improvement Skill for Coding Agents
An autonomous learning skill that allows AI coding agents to log, analyze, and resolve their errors while promoting key insights into long-term project memory.
Agent Browser
A headless browser automation CLI designed for AI agents, providing deterministic element selection via accessibility tree snapshots with refs.
Featured*
