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.py to scan for arbitrage across all active markets
For interesting markets, run analyze_orderbook.py to check if the edge is executable
Run momentum_scanner.py to 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