mcpField
P
polymarket-analyzer

polymarket-analyzer

github.com/mjunaidcaData & databases98486 installsUpdated 35w ago
Repository

About polymarket-analyzer

A read-only skill for analyzing Polymarket prediction markets with data from the Gamma and CLOB APIs, without authentication. It includes scripts for pricing edges, order books, momentum, and portfolio correlation; it does not execute trades.

Key features

  1. 01Scan markets for arbitrage edges
  2. 02Analyze order book depth and imbalance
  3. 03Detect volume and price momentum
  4. 04Identify correlated portfolio exposure
  5. 05Estimate fees and opportunity returns

Use cases

  1. 01Finding pricing inefficiencies across active markets
  2. 02Checking whether an apparent edge is executable
  3. 03Scanning markets for unusual activity
  4. 04Reviewing concentration in related positions

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/mjunaidca/polymarket-skills --skill polymarket-analyzer

After installing, type/polymarket-analyzerin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/
fee-model.md
viable-strategies.md
scripts/
analyze_orderbook.py
correlation_tracker.py
find_edges.py
momentum_scanner.py

Details

From the project README

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

  1. Run find_edges.py to scan for arbitrage across all active markets
  2. For interesting markets, run analyze_orderbook.py to check if the edge is executable
  3. Run momentum_scanner.py to find markets with directional momentum
  4. 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

Comments

Markdown supported