Polymarket Screener

Filter Polymarket prediction markets and track probabilities. Use when screening bets, drafting analyses, outlining trends, tracking price movements.

Security Scan

The skill's code and instructions are consistent with a Polymarket market-screener tool: it only reads Polymarket's public API and writes local cache/log files; minor naming/inclusion inconsistencies are noted but not malicious.

Purpose & Capability

Overall the files and instructions align with a Polymarket screener: the scripts query Polymarket's public API, compute simple filters/scores, and write local cache/report files. Small inconsistencies: SKILL.md examples call scripts/polymarket-screener.sh and polymarket-screener commands, but the shipped executable is scripts/polymarket.sh; a second script (scripts/script.sh) is a content/marketing helper (content-drafting CLI) that is not described in SKILL.md. These are coherence issues but plausibly explainable (naming/packaging mismatch), not evidence of hidden functionality.

Instruction Scope

Runtime instructions tell the user to run local shell scripts that fetch market data from Polymarket and produce reports; the scripts only access the network for polymarket endpoints and write to a per-user data directory (~/.polymarket-screener or XDG_DATA_HOME). The SKILL.md references a script name that doesn't match the file manifest, which could cause confusion or accidental invocation of the wrong script. The included content-assistant script logs commands to local history files, which may record user-provided text.

Install Mechanism

No install spec or external downloads are present; code is shipped as local shell/Python scripts. This is low-risk compared with remote installers or archives pulled from arbitrary URLs.

Credentials

The skill requires no credentials or special environment variables. It respects POLYMARKET_SCREENER_DIR / XDG_DATA_HOME / HOME for local storage. No unrelated secrets or config paths are requested.

Persistence & Privilege

always is false and the skill does not request permanent platform privileges. The scripts create and write only to a dedicated per-user data directory (~/.polymarket-screener or XDG data path) and do not modify other skills or system-wide agent settings.

Assessment

This skill appears to do what it says: it queries Polymarket's public API and writes local cache/reports. Things to check before installing or running: 1) Note the filename mismatch—SKILL.md shows scripts/polymarket-screener.sh but the repo provides scripts/polymarket.sh; confirm which script you'll run. 2) The bundle includes an extra content-assistant script that logs user input to ~/.polymarket-screener (or the XDG data path); if you plan to run prompts or paste sensitive text, be aware those local logs will store it. 3) No credentials are requested and network calls go only to polymarket endpoints listed in the scripts (gamma-api.polymarket.com and polymarket.com). If you want extra caution, run the scripts in a sandbox/container or inspect the files locally, and optionally set POLYMARKET_SCREENER_DIR to a chosen location before running so you know where files are written.

Filter and analyze prediction markets on Polymarket using their public API. Find undervalued bets, track probability movements, and discover high-opportunity markets.

Comparison: Polymarket Screener vs Manual Browsing

Capability	Manual Browsing	Polymarket Screener
Filter by probability range	❌ Limited	✅ Exact range (e.g., 20%-40%)
Filter by liquidity	❌ No	✅ Min/max liquidity filters
Track probability changes	❌ Manual checking	✅ Automated tracking with delta
Multi-category scan	❌ One at a time	✅ All categories at once
Probability movement alerts	❌ No	✅ Configurable thresholds
Historical probability data	❌ Limited chart	✅ Exportable time series
Bulk opportunity scoring	❌ No	✅ Automated scoring
Custom watchlists	❌ No	✅ JSON watchlist with tracking
Export to HTML report	❌ No	✅ Professional report output
Sort by expected value	❌ No	✅ Built-in EV calculator

Getting Started

No API key needed — Polymarket's public API is free.

# List active markets
bash scripts/polymarket-screener.sh list --limit 20

# Filter by category
bash scripts/polymarket-screener.sh list --category politics --limit 50

# Find high-opportunity markets (low probability, high liquidity)
bash scripts/polymarket-screener.sh opportunities --min-liquidity 50000 --prob-range "5-30"

# Track probability changes
bash scripts/polymarket-screener.sh track --market-id MARKET_SLUG --hours 48

# Generate full screening report
bash scripts/polymarket-screener.sh report --output polymarket-report.html

Market Categories

• politics — Elections, legislation, government actions
• crypto — Price predictions, ETF approvals, protocol events
• sports — Game outcomes, championships, player performance
• entertainment — Awards, releases, celebrity events
• science — Space, climate, research milestones
• business — Earnings, IPOs, M&A, market indices
• world — Geopolitics, international events

Opportunity Scoring

Markets are scored based on:

Score = (Liquidity Factor × 0.3) + (Probability Edge × 0.3) + (Time Value × 0.2) + (Movement × 0.2)

Liquidity Factor:  Higher liquidity = higher score (easier to enter/exit)
Probability Edge:  Markets with probabilities far from 50% but trending = opportunity
Time Value:        Markets resolving soon with high uncertainty = valuable
Movement:          Recent probability shifts indicate new information

What Makes a Good Opportunity?

1. Probability between 15-35% or 65-85% — Enough edge without extreme odds
2. Liquidity > $50K — Can enter meaningful position
3. Recent movement > 5% — Market is actively repricing
4. Resolution within 30 days — Time value is concrete
5. Your own knowledge edge — You know something the market doesn't

Output Formats

Command	Description
markets	Markets
odds	Odds
value-bets	Value Bets
watchlist	Watchlist

API Rate Limits

Polymarket's public API has rate limits. The screener respects these automatically:

• 60 requests/minute for listing endpoints
• 120 requests/minute for market detail endpoints
• Built-in retry with exponential backoff

Disclaimer

⚠️ Prediction markets involve real money and financial risk. This tool provides analysis only — it does not place bets or manage positions. Always do your own research.

💬 Feedback & Feature Requests: https://bytesagain.com/feedback Powered by BytesAgain | bytesagain.com

Commands

Run polymarket-screener help to see all available commands.