$npx -y skills add mjunaidca/polymarket-skills --skill polymarket-analyzerUse this skill whenever the user wants to find trading opportunities, detect arbitrage, analyze a market, perform edge detection, find mispricing, do probability analysis, evaluate orderbook depth, find momentum signals, or assess Polymarket market quality. Triggers: "find opport
| 1 | # Polymarket Analyzer Skill |
| 2 | |
| 3 | Detect trading edges and opportunities across Polymarket prediction markets using |
| 4 | real-time data from the Gamma and CLOB APIs. Zero authentication required -- all |
| 5 | analysis is read-only. |
| 6 | |
| 7 | ## Available Scripts |
| 8 | |
| 9 | ### 1. Find Arbitrage Edges (`scripts/find_edges.py`) |
| 10 | |
| 11 | Scans all active markets for pricing inefficiencies: |
| 12 | |
| 13 | - **Underpriced**: YES + NO < $1.00 (guaranteed profit if you buy both sides) |
| 14 | - **Overpriced**: YES + NO > $1.02 (sell opportunity) |
| 15 | - Calculates profit after fees for each opportunity |
| 16 | - Outputs market name, prices, sum, potential profit, and fee impact |
| 17 | |
| 18 | ```bash |
| 19 | python scripts/find_edges.py |
| 20 | python scripts/find_edges.py --min-edge 0.02 --limit 500 |
| 21 | ``` |
| 22 | |
| 23 | ### 2. Analyze Order Book (`scripts/analyze_orderbook.py`) |
| 24 | |
| 25 | Deep analysis of a single market's order book: |
| 26 | |
| 27 | - Spread, mid-price, bid/ask depth (top N levels) |
| 28 | - Bid-ask imbalance ratio (signals directional pressure) |
| 29 | - Thin vs thick book classification |
| 30 | - Liquidity concentration analysis |
| 31 | |
| 32 | ```bash |
| 33 | python scripts/analyze_orderbook.py --token-id <TOKEN_ID> |
| 34 | python scripts/analyze_orderbook.py --token-id <TOKEN_ID> --depth 10 |
| 35 | ``` |
| 36 | |
| 37 | ### 3. Momentum Scanner (`scripts/momentum_scanner.py`) |
| 38 | |
| 39 | Detect markets with unusual activity: |
| 40 | |
| 41 | - **Volume surges**: 24h volume significantly exceeds 7-day average |
| 42 | - **Price momentum**: recent price moves in one direction |
| 43 | - **Liquidity changes**: markets gaining or losing depth |
| 44 | - Ranked output by signal strength |
| 45 | |
| 46 | ```bash |
| 47 | python scripts/momentum_scanner.py |
| 48 | python scripts/momentum_scanner.py --min-volume 10000 --limit 300 |
| 49 | ``` |
| 50 | |
| 51 | ### 4. Correlation Tracker (`scripts/correlation_tracker.py`) |
| 52 | |
| 53 | Detect hidden correlated exposure in your portfolio: |
| 54 | |
| 55 | - Groups positions by topic (crypto, politics, sports, geopolitics, etc.) |
| 56 | - Detects shared qualifiers ("insider trading", "FIFA World Cup", etc.) |
| 57 | - Warns when correlated clusters exceed concentration limits |
| 58 | - Outputs diversification score (0-100) |
| 59 | |
| 60 | ```bash |
| 61 | python scripts/correlation_tracker.py |
| 62 | python scripts/correlation_tracker.py --json |
| 63 | python scripts/correlation_tracker.py --threshold 0.10 |
| 64 | ``` |
| 65 | |
| 66 | ## Workflow |
| 67 | |
| 68 | 1. Run `find_edges.py` to scan for arbitrage across all active markets |
| 69 | 2. For interesting markets, run `analyze_orderbook.py` to check if the edge is executable |
| 70 | 3. Run `momentum_scanner.py` to find markets with directional momentum |
| 71 | 4. Combine findings to identify the best opportunities |
| 72 | |
| 73 | ## Fee Awareness |
| 74 | |
| 75 | Most Polymarket markets are fee-free. Crypto 5-min/15-min markets have dynamic taker |
| 76 | fees: `fee = baseRate * min(price, 1 - price) * size`. See `references/fee-model.md` |
| 77 | for the full fee calculator and breakeven analysis. |
| 78 | |
| 79 | ## Strategy Reference |
| 80 | |
| 81 | See `references/viable-strategies.md` for the four strategies that still work in 2026 |
| 82 | with win rates, expected returns, and risk profiles. |
| 83 | |
| 84 | ## Important Disclaimers |
| 85 | |
| 86 | - This skill performs read-only analysis only -- no trades are executed |
| 87 | - Past patterns do not guarantee future results |
| 88 | - Always verify opportunities manually before trading |
| 89 | - Not financial advice |