Files

T

Polymarket Skills BuilderandClaude Opus 4.6 068b2adc75 Add 6 Polymarket trading skills with paper trading engine

Composable Agent Skills (SKILL.md format) for Polymarket prediction market
trading. Includes scanner, analyzer, monitor, paper trader, strategy advisor,
and live executor. All tested against live Polymarket APIs. Security audited
with all HIGH/MEDIUM findings resolved.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

2026-02-26 07:25:07 +00:00

5.3 KiB

Raw Blame History

Polymarket AI Trading Skills

Composable Agent Skills for Polymarket prediction market trading. Paper-trading-first, security-audited, works with Claude Code, OpenClaw, NanoClaw, Codex, Cursor, and any SKILL.md-compatible agent.

Skills

Skill	What It Does	Auth Required	Risk
polymarket-scanner	Browse, search, and explore live markets	None	Zero
polymarket-analyzer	Detect edges: arbitrage, momentum, wide spreads	None	Zero
polymarket-monitor	Price alerts and position monitoring	None	Zero
polymarket-paper-trader	Simulate trades against live prices (zero risk)	None	Zero
polymarket-strategy-advisor	Trading methodology, recommendations, daily review	None	Low
polymarket-live-executor	Execute real trades (requires wallet + explicit opt-in)	L2 Wallet	Medium

Install

Claude Code / Compatible Agents

npx skills add https://github.com/verticalclaw/polymarket-skills --skill polymarket-scanner
npx skills add https://github.com/verticalclaw/polymarket-skills --skill polymarket-analyzer
npx skills add https://github.com/verticalclaw/polymarket-skills --skill polymarket-monitor
npx skills add https://github.com/verticalclaw/polymarket-skills --skill polymarket-paper-trader
npx skills add https://github.com/verticalclaw/polymarket-skills --skill polymarket-strategy-advisor
npx skills add https://github.com/verticalclaw/polymarket-skills --skill polymarket-live-executor

Manual

Copy any skill folder to ~/.claude/skills/ (or your agent's skill directory).

Dependencies

pip install py-clob-client

Quick Start

Once installed, just talk to your agent naturally:

"Scan Polymarket for interesting markets" — triggers polymarket-scanner
"Find trading opportunities" — triggers polymarket-analyzer
"Set up a paper trading portfolio with $1000" — triggers polymarket-paper-trader
"What should I trade?" — triggers polymarket-strategy-advisor
"Check my portfolio" — triggers polymarket-paper-trader

Full Pipeline Example

# 1. Scan markets
python polymarket-scanner/scripts/scan_markets.py --limit 20 --min-volume 50000

# 2. Find edges
python polymarket-analyzer/scripts/find_edges.py --limit 30

# 3. Get recommendations
python polymarket-strategy-advisor/scripts/advisor.py --top 5 --portfolio-db ~/.polymarket-paper/portfolio.db

# 4. Paper trade
python polymarket-paper-trader/scripts/paper_engine.py --action buy --token TOKEN_ID --side YES --size 50 --reason "Momentum signal"

# 5. Review performance
python polymarket-strategy-advisor/scripts/daily_review.py --portfolio-db ~/.polymarket-paper/portfolio.db

Architecture

polymarket-scanner/          # Read-only market data (Gamma + CLOB APIs)
  scripts/scan_markets.py    # Browse/search markets
  scripts/get_orderbook.py   # Full order book depth
  scripts/get_prices.py      # Current prices/spreads

polymarket-analyzer/         # Edge detection
  scripts/find_edges.py      # Arbitrage, overpriced, wide spread detection
  scripts/momentum_scanner.py # Volume surge + orderbook imbalance signals
  scripts/analyze_orderbook.py # Depth analysis

polymarket-paper-trader/     # Zero-risk simulation engine
  scripts/paper_engine.py    # Core engine (SQLite portfolio)
  scripts/execute_paper.py   # Execute strategy recommendations
  scripts/portfolio_report.py # Sharpe, Sortino, drawdown analytics

polymarket-strategy-advisor/ # Trading methodology
  scripts/advisor.py         # Scan + score + size recommendations
  scripts/daily_review.py    # Performance review + suggestions

polymarket-monitor/          # Position monitoring
  scripts/monitor_prices.py  # Multi-token price polling with alerts
  scripts/watch_market.py    # Continuous single-market snapshots

polymarket-live-executor/    # Real trading (4 safety layers)
  scripts/execute_live.py    # Requires wallet + POLYMARKET_CONFIRM=true
  scripts/check_positions.py # Balance, orders, trade history

Safety Design

Paper trading first: Every strategy runs in simulation before real capital
No wallet by default: Scanner, analyzer, monitor, paper trader, and advisor need zero authentication
Live executor locked: Requires POLYMARKET_PRIVATE_KEY + POLYMARKET_CONFIRM=true + per-trade "yes" confirmation
Risk engine: Position limits, drawdown stops, daily loss limits, concentration caps
Prompt injection protection: All market data sanitized before display (market names are user-generated content)
SQL injection prevention: All queries use parameterized statements
Security audited: See SECURITY-AUDIT.md

APIs Used

API	Endpoint	Auth	Usage
Gamma API	`gamma-api.polymarket.com`	None	Market metadata, search
CLOB API	`clob.polymarket.com`	None (read) / L2 (trade)	Prices, orderbooks, trading

Disclaimer

These skills provide analytical tools and a paper trading simulator
Not financial advice. Past performance does not predict future results
Prediction market trading involves risk of total loss
Always paper trade new strategies before risking real capital
The authors are not responsible for any trading losses

5.3 KiB Raw Blame History