Polymarket Skill: Query Prediction Markets From Your AI Agent

49,000+ downloads and 125 stars — polymarketodds by @joelchance is the most-downloaded market data skill on ClawHub. It gives Claude Code direct access to Polymarket prediction markets: trending events, price history, momentum scanners, watchlist alerts, and paper trading — all through natural language, all without touching a browser.

What Polymarket Is (and Why It's Useful as Data)

Polymarket is a decentralized prediction market running on Polygon. Every market is a yes/no question — "Will X happen by date Y?" — backed by USDC. Prices are set entirely by supply and demand, so a YES share trading at 0.18 USDC means the crowd currently prices that outcome at an 18% probability.

That's not gambling data. It's crowd-sourced probability data that's often faster and more accurate than polls or expert opinion. And because Polymarket's Gamma API is public and requires no authentication, any skill can query it freely.

polymarketodds wraps that API into a unified command interface your AI agent can use directly.

Core Features

Market Discovery

Three commands cover most browsing needs:

# Highest 24h volume markets
python3 ~/.openclaw/skills/polymarketodds/scripts/polymarket.py trending
 
# Keyword search
python3 ~/.openclaw/skills/polymarketodds/scripts/polymarket.py search "trump"
 
# Browse by category
python3 ~/.openclaw/skills/polymarketodds/scripts/polymarket.py category politics

Categories supported: politics, crypto, sports, tech, business. The category command is particularly useful for building focused monitoring agents — one command gives you a digest of all active markets in a domain.

Momentum Scanner

movers finds markets with the biggest price swings over a configurable timeframe:

# 24-hour biggest movers, min $10K volume
python3 ~/.openclaw/skills/polymarketodds/scripts/polymarket.py movers --timeframe 24h --min-volume 10
 
# Weekly movers
python3 ~/.openclaw/skills/polymarketodds/scripts/polymarket.py movers --timeframe 1w

This is the command to run when you want to know what's moving in the market right now — useful for both trading decisions and staying on top of breaking events.

Resolution Calendar

Want to know what markets are about to resolve? calendar shows events with upcoming resolution dates:

# Markets resolving in next 7 days (default)
python3 ~/.openclaw/skills/polymarketodds/scripts/polymarket.py calendar
 
# Next 3 days only
python3 ~/.openclaw/skills/polymarketodds/scripts/polymarket.py calendar --days 3

This is genuinely useful for decision-making: if a market resolves Friday, a 60% YES at Wednesday isn't the same opportunity as the same 60% YES that resolves in 6 months.

Watchlist + Price Alerts

Set up a tracked list of markets with configurable alert thresholds:

# Add with a price target alert (alert when YES hits 70%)
python3 ~/.openclaw/skills/polymarketodds/scripts/polymarket.py watch add trump-2028 --alert-at 70
 
# Add with change alert (alert on ±15% move from current)
python3 ~/.openclaw/skills/polymarketodds/scripts/polymarket.py watch add bitcoin-100k --alert-change 15
 
# List watchlist with current prices
python3 ~/.openclaw/skills/polymarketodds/scripts/polymarket.py watch list

For cron-based monitoring, the alerts command is designed to be silent unless something fires:

# Run every hour — outputs nothing if no alerts triggered
python3 ~/.openclaw/skills/polymarketodds/scripts/polymarket.py alerts --quiet

Pair this with OpenClaw's built-in cron or your system scheduler to get notified the moment a market you're watching crosses a threshold.

Category Digest

A summary command for when you want a snapshot of a whole domain:

python3 ~/.openclaw/skills/polymarketodds/scripts/polymarket.py digest politics
python3 ~/.openclaw/skills/polymarketodds/scripts/polymarket.py digest crypto

Good for weekly briefings: "Every Sunday, give me a politics digest."

Paper Trading

buy and sell let you simulate positions with a $10,000 virtual account — tracking P&L without real money on the line:

# Paper buy $100 on Trump 2028 YES
python3 ~/.openclaw/skills/polymarketodds/scripts/polymarket.py buy trump-2028 100
 
# Check portfolio P&L
python3 ~/.openclaw/skills/polymarketodds/scripts/polymarket.py portfolio
 
# Paper sell a position
python3 ~/.openclaw/skills/polymarketodds/scripts/polymarket.py sell trump-2028

Paper trading is stored locally in portfolio.json. It's useful for testing hypotheses — "if I had bet on X six months ago, where would I be now?" — without any financial exposure.

Practical Agent Workflows

Morning Briefing Integration

Add to your daily cron:

# Trending + biggest movers, every morning at 8am
polymarketodds trending && polymarketodds movers --timeframe 24h

Event-Driven Monitoring

If you follow specific topics (elections, economic reports, crypto), the combination of watch + alerts --quiet + cron creates a lightweight notification system:

1. Add markets you care about to your watchlist
2. Run alerts --quiet hourly
3. Your agent notifies you only when something crosses your threshold

Research Assistant

Natural language queries like "what's the current probability of a Fed rate cut in March?" become simple:

python3 ~/.openclaw/skills/polymarketodds/scripts/polymarket.py search "fed rate cut march"

Then fetch the specific event for full detail:

python3 ~/.openclaw/skills/polymarketodds/scripts/polymarket.py event fed-rate-cut-march-2026

Comparison: polymarketodds vs Alternatives

How to Install

clawhub install polymarketodds

No environment variables required. The skill uses Polymarket's public Gamma API — no API key, no account, no rate-limit management needed. Python 3 and requests are the only dependencies, and the skill handles installation of those automatically.

Practical Tips

1. Use --quiet in cron — Without it, alerts outputs the full watchlist every run, which creates noise. --quiet prints nothing unless an alert fires.

2. Combine search + event — search returns a list; event [slug] gives the full picture. Use both in sequence to drill down.

3. Paper trade before going live — If you're considering real trades, run the same decisions through paper trading for 2-4 weeks first. The built-in portfolio tracker makes it easy to see whether your edge is real.

4. Use calendar for time-sensitive bets — A market near resolution behaves differently from one with months left. Check resolution dates before assessing odds.

5. digest for weekly roundups — Rather than browsing manually, schedule a weekly digest politics && digest crypto to get a comprehensive snapshot.

Considerations

• Paper trading only simulates market orders at current price — Real Polymarket uses a CLOB (Central Limit Order Book), so actual fills may differ from simulated ones, especially in illiquid markets.
• Odds are crowd-sourced — They reflect market participant beliefs, not guaranteed probabilities. Thin markets can be manipulated or poorly calibrated.
• No real trading in this skill — polymarketodds is read-only plus paper trading. For actual on-chain trading, you'd need a separate setup with wallet management and Polygon USDC.
• API availability — Polymarket's public API has no SLA. Extended downtime is rare but possible.

The Bigger Picture

Prediction markets represent a fundamentally different kind of data source — not what experts think will happen, but what the market will pay for outcomes. When political events, economic decisions, or tech announcements drive real-money trades, the resulting prices are surprisingly well-calibrated.

Having that data stream accessible from your AI agent changes what's possible. Morning briefings can include crowd-sourced probability estimates for the news stories you're tracking. Research workflows can cross-reference expert analysis against market odds. Monitoring agents can fire when the market significantly updates its view of an event you care about.

polymarketodds makes all of this a one-command operation.

View the skill on ClawHub: polymarketodds