Summary
Scans Polymarket prediction markets for trading edges using their public APIs. The four scripts cover the basics: finding arbitrage (when YES + NO prices don't sum to $1), analyzing order book depth to see if an edge is actually tradable, detecting volume and price momentum, and tracking correlated exposure across your positions. No authentication needed since it's all read-only analysis. The fee awareness is solid, especially the note about dynamic fees on crypto short-term markets. Honest about limitations and includes a reference doc on strategies that still work. If you're actively trading prediction markets or just curious about market inefficiencies, this gives you the scanning infrastructure without having to write it yourself.
Install to Claude Code
npx -y skills add mjunaidca/polymarket-skills --skill polymarket-analyzer --agent claude-codeInstalls into .claude/skills of the current project.
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →
Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
Files
SKILL.mdView on GitHub
Polymarket Analyzer Skill
Detect trading edges and opportunities across Polymarket prediction markets using real-time data from the Gamma and CLOB APIs. Zero authentication required -- all analysis is read-only.
Available Scripts
1. Find Arbitrage Edges (scripts/find_edges.py)
Scans all active markets for pricing inefficiencies:
- Underpriced: YES + NO < $1.00 (guaranteed profit if you buy both sides)
- Overpriced: YES + NO > $1.02 (sell opportunity)
- Calculates profit after fees for each opportunity
- Outputs market name, prices, sum, potential profit, and fee impact
python scripts/find_edges.py
python scripts/find_edges.py --min-edge 0.02 --limit 500
2. Analyze Order Book (scripts/analyze_orderbook.py)
Deep analysis of a single market's order book:
- Spread, mid-price, bid/ask depth (top N levels)
- Bid-ask imbalance ratio (signals directional pressure)
- Thin vs thick book classification
- Liquidity concentration analysis
python scripts/analyze_orderbook.py --token-id <TOKEN_ID>
python scripts/analyze_orderbook.py --token-id <TOKEN_ID> --depth 10
3. Momentum Scanner (scripts/momentum_scanner.py)
Detect markets with unusual activity:
- Volume surges: 24h volume significantly exceeds 7-day average
- Price momentum: recent price moves in one direction
- Liquidity changes: markets gaining or losing depth
- Ranked output by signal strength
python scripts/momentum_scanner.py
python scripts/momentum_scanner.py --min-volume 10000 --limit 300
4. Correlation Tracker (scripts/correlation_tracker.py)
Detect hidden correlated exposure in your portfolio:
- Groups positions by topic (crypto, politics, sports, geopolitics, etc.)
- Detects shared qualifiers ("insider trading", "FIFA World Cup", etc.)
- Warns when correlated clusters exceed concentration limits
- Outputs diversification score (0-100)
python scripts/correlation_tracker.py
python scripts/correlation_tracker.py --json
python scripts/correlation_tracker.py --threshold 0.10
Workflow
- Run
find_edges.pyto scan for arbitrage across all active markets - For interesting markets, run
analyze_orderbook.pyto check if the edge is executable - Run
momentum_scanner.pyto find markets with directional momentum - Combine findings to identify the best opportunities
Fee Awareness
Most Polymarket markets are fee-free. Crypto 5-min/15-min markets have dynamic taker
fees: fee = baseRate * min(price, 1 - price) * size. See references/fee-model.md
for the full fee calculator and breakeven analysis.
Strategy Reference
See references/viable-strategies.md for the four strategies that still work in 2026
with win rates, expected returns, and risk profiles.
Important Disclaimers
- This skill performs read-only analysis only -- no trades are executed
- Past patterns do not guarantee future results
- Always verify opportunities manually before trading
- Not financial advice
Featured
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
