polymarket-scanner_skill

Overview

This skill automates scanning and trading on Polymarket using the Simmer Markets API. It finds mispriced prediction markets, evaluates opportunities by score and divergence, and can execute virtual ($SIM) or real (USDC) trades under configurable rules. It is designed to run on a schedule and to log all activity for audit and review.

How this skill works

The scanner fetches balances, open positions, and recent market prices from Polymarket and compares them to external price signals to compute opportunity scores and price divergence. It filters opportunities with built-in trading rules (position limits, stop-losses, minimum score/divergence) and either places virtual trades automatically or prepares real USDC trades that require human confirmation. All actions, warnings, and executed orders are recorded to a JSONL trading log and optional Telegram notifications.

When to use it

• Periodically scan Polymarket for arbitrage and mispricing (cron every few hours).
• Evaluate and manage an active Polymarket portfolio or check current positions and balances.
• Run automated virtual trading to backtest strategies or simulate risk limits.
• Prepare and execute small, controlled real-money trades with human confirmation.
• Detect momentum shifts or event-driven opportunities using external data feeds.

Best practices

• Set SIMMER_API_KEY securely as an environment variable and confirm the Simmer agent is claimed before running.
• Start with virtual ($SIM) mode to validate filters, scoring, and stop-loss behavior before enabling USDC trading.
• Tune min opportunity score and divergence thresholds to match desired risk level and market liquidity.
• Keep balance and position limits conservative; the defaults include single-trade and daily caps plus max open positions.
• Enable logging and periodic reviews of trading_log.jsonl to audit decisions and refine rules.

Example use cases

• Automatically scan top markets every 4 hours to find price divergences between Polymarket and external sources.
• Simulate a trading day using virtual $SIM to test a cross-platform arbitrage strategy.
• Notify a trader via Telegram when a high-scoring opportunity appears and await manual USDC execution.
• Enforce risk controls: skip markets with large spreads, avoid already-held markets, and halt real trading when balance is too low.
• Run quick checks for positions or account status with command-line flags for --positions or --status.