🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
BytesAgain β€Ί Skills β€Ί Polymarket FastLoop Trader
πŸ¦€ ClawHub

Polymarket FastLoop Trader

by @andrewbrownrd

Trade Polymarket BTC/ETH/SOL 5/15-minute fast markets with momentum and order book filters.

Versionv1.0.10
Downloads1,107
#clawhub
TERMINAL
clawhub install polymarket-simmer-fastloop

πŸ“– About This Skill

name: polymarket-simmer-fastloop displayName: Polymarket Simmer FastLoop Trader description: Trade Polymarket BTC/ETH/SOL 5/15-minute fast markets with momentum and order book filters. version: "1.1.0" author: "Xuano47" tags: ["polymarket", "trading", "btc", "eth", "sol"] env: - SIMMER_API_KEY - TRADING_VENUE

Polymarket Simmer FastLoop Trader

> [!TIP] > This is a template. The default signal is a Mean Reversion strategy using Binance momentum exhaustion and L2 order book imbalance. > Remix it with alternative signals like trend-following momentum, social sentiment feeds, or cross-venue arbitrage models. > The skill handles all the plumbing (market discovery, fee-accurate EV math, position tracking). Your agent provides the alpha.

Automated trading skill for Polymarket BTC/ETH/SOL 5-minute and 15-minute fast markets.

> Default is paper mode. Use --live for real trades.

Strategy

When the latest 5-minute candle shows a rapid spike (momentum > threshold) the script buys the reverse side, capturing the pullback. Signals are filtered by:

  • Momentum: Binance 1-minute candles, configurable threshold (default 1.0%).
  • Order Book Imbalance (optional): Top 20 levels of Binance L2 book confirm directional bias.
  • NOFX Institutional Netflow: Filters trades using institutional flow data.
  • Time-of-Day Filter: Skips low-liquidity hours (02:00–06:00 UTC) by default.
  • Fee-Accurate EV: Only trades when divergence exceeds fee breakeven + buffer.
  • Volatility-Adjusted Sizing: High volatility reduces position size automatically.
  • Pre-Caching (Ignition): On every run, the skill scans and caches upcoming market IDs to disk (fast_markets_cache.json). At market open, the Simmer API briefly hides the market β€” the skill uses the cache to execute trades during this "API blackout" window, ensuring no opportunity is missed.

    • Setup

    1. Get Simmer API Key

  • Register at simmer.markets.
  • Go to Dashboard -> SDK tab.
  • Copy your API key: export SIMMER_API_KEY="your-key-here".

    • 2. Required Environment Variables

    | Variable | Required | Description | Values | |----------|----------|-------------|--------| | SIMMER_API_KEY | Yes | Your Simmer SDK key | Get from simmer.markets | | TRADING_VENUE | Yes | Execution environment | simmer (Paper) or polymarket (Live) | | WALLET_PRIVATE_KEY | Optional | Your Polymarket wallet key | Required only if TRADING_VENUE="polymarket" |

  • simmer (Default): Paper Trading. Simulates trades using virtual funds. No real USDC needed.
  • polymarket: Real Trading. Connects to Polymarket. You must have USDC in the wallet.

    • > [!WARNING] > Never share your WALLET_PRIVATE_KEY or SIMMER_API_KEY. The SDK signs trades locally; your private key is never transmitted.

    Quick Start

    pip install simmer-sdk
export SIMMER_API_KEY="your-key-here"
    Paper mode (default)
    
python polymarket-simmer-fastloop.py
    Live trading
    
python polymarket-simmer-fastloop.py --live
    Check win rate and P&L stats
    
python polymarket-simmer-fastloop.py --stats
    Resolve expired trades against real outcomes
    
python polymarket-simmer-fastloop.py --resolve
    Quiet mode for cron
    
python polymarket-simmer-fastloop.py --live --quiet

    Cron Setup

    OpenClaw: 

    openclaw cron add \
  --name "Simmer FastLoop" \
  --cron "*/5 * * * *" \
  --tz "UTC" \
  --session isolated \
  --message "Run: cd /path/to/skill && python polymarket-simmer-fastloop.py --live --quiet. Show output summary." \
  --announce

    Linux crontab: 

    */5 * * * * cd /path/to/skill && python polymarket-simmer-fastloop.py --live --quiet

    All Settings

    | Setting | Default | Description | |---------|---------|-------------| | entry_threshold | 0.05 | Min divergence from 50c | | min_momentum_pct | 1.0 | Min % asset move to trigger | | max_position | 5.0 | Max $ per trade | | signal_source | binance | binance or coingecko | | lookback_minutes | 5 | Candle lookback window | | min_time_remaining | 60 | Skip if < N seconds left | | target_time_min | 90 | Prefer markets with >= N seconds left | | target_time_max | 210 | Prefer markets with <= N seconds left | | asset | BTC | BTC, ETH, or SOL | | window | 5m | 5m or 15m | | volume_confidence | true | Skip low-volume signals | | require_orderbook | false | Require order book confirmation | | time_filter | true | Skip 02:00–06:00 UTC | | vol_sizing | true | Adjust size by volatility | | fee_buffer | 0.05 | Extra edge above fee breakeven | | daily_budget | 10.0 | Max spend per UTC day | | starting_balance | 1000.0 | Paper portfolio starting balance |

    🎨 Remixing the Signal

    This skill is a remixable template. We distinguish between Plumbing (Infrastructure) and Alpha (Strategy).

    Core Components:

    * The Plumbing (Structural): Market discovery (Gamma/Simmer fallback), Pre-Caching, execution via Simmer SDK, and fee-accurate EV calculations. * The Alpha (Replaceable): The decision-making logic inside run_strategy where side is determined based on CEX signals.

    How to Remix:

    1. Find the Signal logic: In polymarket-simmer-fastloop.py, look for the run_strategy function around line ~950. 2. Modify the Decision: - Swap the side = "no" and side = "yes" logic to change from Mean Reversion to Trend Following. - Replace get_momentum with your own model or API (e.g., custom XGBoost classifier or GPT-4o signal). 3. Refine Execution: Edit calculate_position_size to implement custom risk management formulas.

    *Use this template to bypass the complexity of Polymarket's order book and focus entirely on your strategy logic.*

    Troubleshooting

    "Momentum below threshold" β€” Asset move is too small. Lower min_momentum_pct if needed.

    "Order book imbalance: neutral" β€” Market is balanced, signal skipped when require_orderbook=true.

    "Time filter: low liquidity window" β€” Current hour is 02–06 UTC. Set time_filter=false to override.

    πŸ’‘ Examples

    pip install simmer-sdk
export SIMMER_API_KEY="your-key-here"
    Paper mode (default)
    
python polymarket-simmer-fastloop.py
    Live trading
    
python polymarket-simmer-fastloop.py --live
    Check win rate and P&L stats
    
python polymarket-simmer-fastloop.py --stats
    Resolve expired trades against real outcomes
    
python polymarket-simmer-fastloop.py --resolve
    Quiet mode for cron
    
python polymarket-simmer-fastloop.py --live --quiet

    βš™οΈ Configuration

    1. Get Simmer API Key

  • Register at simmer.markets.
  • Go to Dashboard -> SDK tab.
  • Copy your API key: export SIMMER_API_KEY="your-key-here".

    • 2. Required Environment Variables

    | Variable | Required | Description | Values | |----------|----------|-------------|--------| | SIMMER_API_KEY | Yes | Your Simmer SDK key | Get from simmer.markets | | TRADING_VENUE | Yes | Execution environment | simmer (Paper) or polymarket (Live) | | WALLET_PRIVATE_KEY | Optional | Your Polymarket wallet key | Required only if TRADING_VENUE="polymarket" |

  • simmer (Default): Paper Trading. Simulates trades using virtual funds. No real USDC needed.
  • polymarket: Real Trading. Connects to Polymarket. You must have USDC in the wallet.

    • > [!WARNING] > Never share your WALLET_PRIVATE_KEY or SIMMER_API_KEY. The SDK signs trades locally; your private key is never transmitted.

    πŸ“‹ Tips & Best Practices

    "Momentum below threshold" β€” Asset move is too small. Lower min_momentum_pct if needed.

    "Order book imbalance: neutral" β€” Market is balanced, signal skipped when require_orderbook=true.

    "Time filter: low liquidity window" β€” Current hour is 02–06 UTC. Set time_filter=false to override.