← Back to Skills Marketplace
Polymarket
by
joelchance
· GitHub ↗
· v1.0.6
· MIT-0
232503
Downloads
145
Stars
46
Active Installs
7
Versions
Install in OpenClaw
/install polymarket-trade
Description
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
README (SKILL.md)
Step-by-Step Guide
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
Quick Start
# Trending markets
python3 {baseDir}/scripts/polymarket.py trending
# Search
python3 {baseDir}/scripts/polymarket.py search "trump"
# Biggest movers
python3 {baseDir}/scripts/polymarket.py movers
# What's resolving soon
python3 {baseDir}/scripts/polymarket.py calendar
After Install — Suggested Setup
1. Add to Morning Briefing
Add Polymarket to your daily cron:
polymarket featured + polymarket movers --timeframe 24h
2. Watch Markets You Care About
# Watch with price target alert
python3 {baseDir}/scripts/polymarket.py watch add trump-2028 --alert-at 60
# Watch with change alert (±10% from current)
python3 {baseDir}/scripts/polymarket.py watch add bitcoin-100k --alert-change 10
3. Set Up Hourly Alerts (Cron)
# Check watchlist every hour, only notify on alerts
python3 {baseDir}/scripts/polymarket.py alerts --quiet
4. Weekly Category Digests
# Every Sunday: politics digest
python3 {baseDir}/scripts/polymarket.py digest politics
5. Paper Trade to Track Predictions
python3 {baseDir}/scripts/polymarket.py buy trump-2028 100 # $100 on Trump
python3 {baseDir}/scripts/polymarket.py portfolio # Check P&L
Commands
Core
# Trending markets (by 24h volume)
python3 {baseDir}/scripts/polymarket.py trending
# Featured/high-profile markets
python3 {baseDir}/scripts/polymarket.py featured
# Search markets
python3 {baseDir}/scripts/polymarket.py search "giannis"
# Get event by slug
python3 {baseDir}/scripts/polymarket.py event trump-2028
# Browse by category
python3 {baseDir}/scripts/polymarket.py category politics
Watchlist + Alerts (NEW)
# Add to watchlist
python3 {baseDir}/scripts/polymarket.py watch add trump-2028
python3 {baseDir}/scripts/polymarket.py watch add bitcoin-100k --alert-at 70
python3 {baseDir}/scripts/polymarket.py watch add fed-rate-cut --alert-change 15
# Watch specific outcome in multi-market
python3 {baseDir}/scripts/polymarket.py watch add giannis-trade --outcome warriors
# List watchlist with current prices
python3 {baseDir}/scripts/polymarket.py watch list
# Remove from watchlist
python3 {baseDir}/scripts/polymarket.py watch remove trump-2028
# Check for alerts (for cron)
python3 {baseDir}/scripts/polymarket.py alerts
python3 {baseDir}/scripts/polymarket.py alerts --quiet # Only output if triggered
Resolution Calendar (NEW)
# Markets resolving in next 7 days
python3 {baseDir}/scripts/polymarket.py calendar
# Markets resolving in next 3 days
python3 {baseDir}/scripts/polymarket.py calendar --days 3
# More results
python3 {baseDir}/scripts/polymarket.py calendar --days 14 --limit 20
Momentum Scanner (NEW)
# Biggest movers (24h)
python3 {baseDir}/scripts/polymarket.py movers
# Weekly movers
python3 {baseDir}/scripts/polymarket.py movers --timeframe 1w
# Monthly movers with volume filter
python3 {baseDir}/scripts/polymarket.py movers --timeframe 1m --min-volume 50
Category Digests (NEW)
# Politics digest
python3 {baseDir}/scripts/polymarket.py digest politics
# Crypto digest
python3 {baseDir}/scripts/polymarket.py digest crypto
# Sports digest
python3 {baseDir}/scripts/polymarket.py digest sports
Categories: politics, crypto, sports, tech, business
Paper Trading (NEW)
# Buy $100 of a market
python3 {baseDir}/scripts/polymarket.py buy trump-2028 100
# Buy specific outcome
python3 {baseDir}/scripts/polymarket.py buy giannis-trade 50 --outcome warriors
# View portfolio
python3 {baseDir}/scripts/polymarket.py portfolio
# Sell position
python3 {baseDir}/scripts/polymarket.py sell trump-2028
Starts with $10,000 paper cash. Track your predictions without real money.
Data Storage
Watchlist and portfolio stored in ~/.polymarket/:
watchlist.json— Watched markets and alert thresholdsportfolio.json— Paper positions and trade history
Cron Examples
Hourly Alert Check
0 * * * * python3 ~/.../polymarket.py alerts --quiet
Daily Morning Brief
0 7 * * * python3 ~/.../polymarket.py movers && python3 ~/.../polymarket.py calendar --days 1
Weekly Digests
0 10 * * 0 python3 ~/.../polymarket.py digest politics
0 10 * * 0 python3 ~/.../polymarket.py digest crypto
Output Features
Markets show:
- Current odds (Yes/No prices)
- Price momentum (24h/1wk/1mo changes with arrows)
- Volume (total + 24h activity)
- Time remaining
- Bid/ask spread
API
Uses the public Gamma API (no auth required for reading):
- Base URL:
https://gamma-api.polymarket.com - Docs: https://docs.polymarket.com
Security & Permissions
No API key or authentication required. This skill uses Polymarket's public Gamma API.
What this skill does:
- Makes HTTPS GET requests to
gamma-api.polymarket.com(public, unauthenticated) - Reads market data: odds, volumes, event details, price history
- Paper trading is local simulation only — stored in
~/.polymarket/as JSON files - No real money, no wallet, no blockchain transactions
What this skill does NOT do:
- Does not connect to any wallet or financial account
- Does not execute real trades or transactions
- Does not require or handle any credentials or API keys
- Does not send any personal data externally
- Cannot be invoked autonomously by the agent (
disable-model-invocation: true)
Data stored locally: ~/.polymarket/watchlist.json, ~/.polymarket/portfolio.json
Review scripts/polymarket.py before first use to verify behavior.
Note
This is read-only + paper trading. Real trading requires wallet authentication (not implemented).
Usage Guidance
Install this as a read-only Polymarket data and local paper-trading helper. Be aware it can write local state under ~/.polymarket and can run repeatedly if you manually add the suggested cron jobs. Do not treat the linked external guide as vetted financial advice, and remove cron entries plus ~/.polymarket files if you stop using it.
Capability Tags
Capability Assessment
Purpose & Capability
The artifacts fit a Polymarket lookup and tracking skill: public market queries, alerts, digests, and simulated portfolio commands. The external guide link is a trust consideration, but the code does not implement wallet access, real trades, fund movement, or credential handling.
Instruction Scope
Commands are user-invoked, and the manifest disables autonomous model invocation. Cron examples are documented as optional user setup rather than hidden automatic execution.
Install Mechanism
No install-time execution or package mutation is shown. The frontmatter only declares python3 while the script has an inline requests dependency, which is a documentation gap rather than a security concern.
Credentials
Runtime behavior is proportionate: HTTPS GET requests to gamma-api.polymarket.com and local JSON storage under ~/.polymarket for watchlist and portfolio state. No unrelated endpoints, subprocess execution, credential reads, wallet access, or broad filesystem scanning were found.
Persistence & Privilege
Persistence is limited to disclosed watchlist.json and portfolio.json files in ~/.polymarket. Optional cron examples could create ongoing checks only if the user installs them manually.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install polymarket-trade - After installation, invoke the skill by name or use
/polymarket-trade - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.6
- No changes detected to commands or core functionality.
v1.0.5
- No changes to core features, commands, or usage.
v1.0.4
- No changes to code or functionality.
v1.0.3
- Updated SKILL.md to replace repeated "How Building a Weather Polymarket Bot..." links with clearer "How to use" links.
- No changes to code or functionality; documentation only.
- All usage examples, commands, and security explanations remain as before.
v1.0.2
No user-facing changes in this version.
- Documentation and metadata remain unchanged.
- No code or content updates detected.
v1.0.1
- Nothing added.
v1.0.0
Initial release of the new Polymarket query and paper trading tool.
- Major overhaul: renamed to "polymarket" and fully repurposed for prediction markets.
- New script: Added scripts/polymarket.py for querying odds, trends, searching events, alerts, digests, and paper trading.
- Removed legacy BTC trading strategy tools and Binance scripts.
- Now includes watchlist, local paper trading, resolution calendar, and a momentum scanner.
- All functions use Polymarket's public API without authentication.
- No real-money trading; all trading is simulated and stored locally.
Metadata
Frequently Asked Questions
What is Polymarket?
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements. It is an AI Agent Skill for Claude Code / OpenClaw, with 232503 downloads so far.
How do I install Polymarket?
Run "/install polymarket-trade" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Polymarket free?
Yes, Polymarket is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Polymarket support?
Polymarket is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Polymarket?
It is built and maintained by joelchance (@joelchance); the current version is v1.0.6.
More Skills