← Back to Skills Marketplace
Polymarket
by
joelchance
· GitHub ↗
· v1.0.6
· MIT-0
171295
Downloads
110
Stars
36
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 only if you want public Polymarket market lookups and local paper-trading tracking. Do not follow the external profit-guide link blindly, do not provide wallet credentials or funds, review any cron jobs before adding them, and periodically check or remove the ~/.polymarket/ files if you do not want that local history retained.
Capability Analysis
Type: OpenClaw Skill
Name: polymarket-trade
Version: 1.0.6
The polymarket-trade skill bundle is a legitimate tool for querying Polymarket prediction data and performing local paper trading simulations. The Python script `scripts/polymarket.py` interacts with the public Polymarket Gamma API (https://gamma-api.polymarket.com) and stores watchlist and portfolio data locally in the user's home directory (~/.polymarket/). The code is well-structured, lacks obfuscation, and does not exhibit any signs of data exfiltration, malicious execution, or unauthorized persistence.
Capability Tags
Capability Assessment
Purpose & Capability
The core commands and visible code align with querying Polymarket and local paper trading, but the documentation promotes an off-platform guide about turning $100 into $8000 with a bot, which is not necessary for the stated read-only market-query purpose.
Instruction Scope
The skill is user-invocable and model invocation is disabled; the documented cron commands are user-directed examples rather than automatic execution, but they would create recurring activity if the user installs them.
Install Mechanism
There is no install spec and only python3 is declared as required, while the script declares a requests dependency; users may need to ensure dependency installation comes from a trusted environment.
Credentials
The SKILL.md claims no wallet, credentials, or real trades, and the visible code uses the public Gamma API plus local JSON files; however, the capability signals include requires-wallet, creating a wallet-permission ambiguity users should verify.
Persistence & Privilege
The skill stores watchlist and paper-portfolio state under ~/.polymarket/ and suggests optional cron jobs for alerts and digests; this is disclosed and purpose-aligned but persists until the user removes it.
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
More Skills