polymarket-fast-loop

Polymarket FastLoop Trader

Trade Polymarket's 5-minute crypto fast markets using real-time price signals. Default: BTC momentum from Binance. Works with ETH and SOL too.

Polymarket only. All trades execute on Polymarket with real USDC. Use --live for real trades, dry-run is the default.

This is a template. The default signal (Binance momentum) gets you started — remix it with your own signals, data sources, or strategy. The skill handles all the plumbing (market discovery, import, trade execution). Your agent provides the alpha.

⚠️ Fast markets carry Polymarket's crypto taker fee (is_paid: true). Effective rate is 3.5% at 50¢, up to ~6.6% on cheap shares (e.g. 5¢ NO). Makers pay 0% and earn a 20% rebate from collected taker fees. Factor this into your edge calculations.

⚠️ Risk monitoring does not apply to sub-15-minute markets. Simmer's stop-loss and take-profit monitors check positions every 15 minutes — which means they will never fire on 5m or 15m markets before resolution. Any risk settings you configure in the Simmer dashboard have no effect on these positions. Size accordingly and do not rely on automated stop-losses for fast market trades.

News-recency veto. Optional guard that checks Simmer's macro-news schedule before order placement and skips matching news-resolution markets inside the first 30 seconds after CPI, BLS jobs/unemployment, FOMC, nonfarm payrolls, or quarterly earnings events. Continuous-feed crypto Up/Down markets are not blocked by this veto. Default is off until internal positive backfill coverage exists; set enable_news_veto=true to enable it.

How It Finds Markets

• Queries Polymarket directly (Gamma API) for live fast markets — doesn't depend on Simmer's market inventory
• Discovers new markets as they appear, every cycle
• Works with BTC, ETH, or SOL — just change the asset (--set asset=ETH) or ask your bot to look for whatever market you want
• Runs every 5 minutes to catch each trading window (or every 1 minute for mid-window opportunities)

You don't need to wait for markets to show up in Simmer. FastLoop finds them in real-time on Polymarket, then imports and trades them through Simmer.

🚨 Framework, not a production trading system. Read DISCLAIMER.md before connecting to a wallet with real funds.

When to Use This Skill

Use this skill when the user wants to:

• Trade crypto sprint/fast markets (5-minute or 15-minute) on any supported asset
• Automate short-term crypto prediction trading
• Use CEX price momentum (or any custom signal) as a Polymarket signal
• Monitor sprint market positions

Setup Flow

When user asks to install or configure this skill:

1. Install the Simmer SDK

   pip install simmer-sdk
   

2. Ask for Simmer API key

   • Get from simmer.markets/dashboard → SDK tab
   • Store in environment as SIMMER_API_KEY

3. Ask for wallet private key (required for live trading)

   • This is the private key for their Polymarket wallet (the wallet that holds USDC)
   • Store in environment as WALLET_PRIVATE_KEY
   • The SDK uses this to sign orders client-side automatically — no manual signing needed

4. Ask about settings (or confirm defaults)

   • Asset: BTC, ETH, or SOL (default BTC)
   • Entry threshold: Min divergence to trade (default 5¢)
   • Max position: Amount per trade (default $5.00)
   • Window: 5m or 15m (default 5m)

5. Set up cron or loop (user drives scheduling — see "How to Run on a Loop")

Quick Start

# Set your API key
export SIMMER_API_KEY="your-key-here"

# Dry run — see what would happen
python fastloop_trader.py

# Go live
python fastloop_trader.py --live

# Live + quiet (for cron/heartbeat loops)
python fastloop_trader.py --live --quiet

# Live + smart sizing (5% of balance per trade)
python fastloop_trader.py --live --smart-sizing --quiet

How to Run on a Loop

The script runs one cycle — your bot drives the loop. Set up a cron job or heartbeat:

Linux crontab (local/VPS installs):

# Every 5 minutes (one per fast market window)
*/5 * * * * cd /path/to/skill && python fastloop_trader.py --live --quiet

# Every 1 minute (more aggressive, catches mid-window opportunities)
* * * * * cd /path/to/skill && python fastloop_trader.py --live --quiet

OpenClaw native cron (containerized or OpenClaw-managed setups):

openclaw cron add \
  --name "Fast Loop Trader" \
  --cron "*/5 * * * *" \
  --tz "UTC" \
  --session isolated \
  --message "Run fast loop trader: cd /path/to/skill && python fastloop_trader.py --live --quiet. Show the output summary." \
  --announce

Via OpenClaw heartbeat: Add to your HEARTBEAT.md:

Run: cd /path/to/fast market && python fastloop_trader.py --live --quiet

Configuration

Configure via config.json, environment variables, or --set:

# Change entry threshold
python fastloop_trader.py --set entry_threshold=0.08

# Trade ETH instead of BTC
python fastloop_trader.py --set asset=ETH

# Multiple settings
python fastloop_trader.py --set min_momentum_pct=0.3 --set max_position=10

Settings

Example config.json

{
  "entry_threshold": 0.08,
  "min_momentum_pct": 0.3,
  "max_position": 10.0,
  "asset": "BTC",
  "window": "5m",
  "signal_source": "binance",
  "enable_news_veto": false
}

CLI Options

python fastloop_trader.py                    # Dry run
python fastloop_trader.py --live             # Real trades
python fastloop_trader.py --live --quiet     # Silent except trades/errors
python fastloop_trader.py --smart-sizing     # Portfolio-based sizing
python fastloop_trader.py --positions        # Show open fast market positions
python fastloop_trader.py --config           # Show current config
python fastloop_trader.py --set KEY=VALUE    # Update config

Signal Logic

Default signal (Binance momentum):

1. Fetch last 5 one-minute candles from Binance (BTCUSDT)
2. Calculate momentum: (price_now - price_5min_ago) / price_5min_ago
3. Compare momentum direction to current Polymarket odds
4. Trade when:
   • Momentum ≥ min_momentum_pct (default 0.5%)
   • Price diverges from 50¢ by ≥ entry_threshold (default 5¢)
   • Volume ratio > 0.5x average (filters out thin moves)

Example: BTC up 0.8% in last 5 min, but fast market YES price is only $0.52. The 3¢ divergence from the expected ~$0.55 → buy YES.

Remix It: Plug In Your Own Signal

This skill is a template. The default Binance momentum signal is just a starting point. The skill handles all the boring parts (market discovery, import, order execution, budget tracking). You bring the signal.

Ideas for custom signals:

• Multi-exchange spreads: Compare prices across Binance, Kraken, Bitfinex — divergence between exchanges can predict CLOB direction
• Sentiment: Layer in Twitter/social signals — a viral tweet can move fast markets before the CLOB adjusts
• Technical indicators: RSI, VWAP, order flow analysis from your favorite data source
• News: Breaking news correlation — use your agent's reasoning to interpret headlines
• On-chain data: Whale movements, funding rates, liquidation levels

To customize, edit get_momentum() in fastloop_trader.py or add your own signal function. The rest of the skill (discovery, import, sizing, fee-aware EV check) stays the same.

Example Output

⚡ Simmer FastLoop Trading Skill
==================================================

  [DRY RUN] No trades will be executed. Use --live to enable trading.

⚙️  Configuration:
  Asset:            BTC
  Entry threshold:  0.05 (min divergence from 50¢)
  Min momentum:     0.5% (min price move)
  Max position:     $5.00
  Signal source:    binance
  Lookback:         5 minutes
  Min time left:    60s
  Volume weighting: ✓

🔍 Discovering BTC fast markets...
  Found 3 active fast markets

🎯 Selected: Bitcoin Up or Down - February 15, 5:30AM-5:35AM ET
  Expires in: 185s
  Current YES price: $0.480

📈 Fetching BTC price signal (binance)...
  Price: $97,234.50 (was $96,812.30)
  Momentum: +0.436%
  Direction: up
  Volume ratio: 1.45x avg

🧠 Analyzing...
  ⏸️  Momentum 0.436% < minimum 0.500% — skip

📊 Summary: No trade (momentum too weak: 0.436%)

Source Tagging

All trades are tagged with source: "sdk:fastloop". This means:

• Portfolio shows breakdown by strategy
• Other skills won't interfere with your fast market positions
• You can track fast market P&L separately

Troubleshooting

"No active fast markets found"

• Fast markets may not be running (off-hours, weekends)
• Check Polymarket directly for active BTC fast markets

"No fast markets with >60s remaining"

• Current window is about to expire, next one isn't live yet
• Reduce min_time_remaining if you want to trade closer to expiry

"Import failed: Rate limit exceeded"

• Free tier: 10 imports/day. Pro: 50/day
• Fast market trading needs Pro for reasonable frequency

"Failed to fetch price data"

• Binance API may be down or rate limited
• Try --set signal_source=coingecko as fallback

"Trade failed: no liquidity"

• Fast market has thin book, try smaller position size

"External wallet requires a pre-signed order"

• WALLET_PRIVATE_KEY is not set in the environment
• The SDK signs orders automatically when this env var is present — no manual signing code needed
• Fix: export WALLET_PRIVATE_KEY=0x<your-polymarket-wallet-private-key>
• Do NOT attempt to sign orders manually or modify the skill code — the SDK handles it

"Balance shows $0 but I have funds on Polygon"

• Polymarket V2 (live 2026-04-28) uses pUSD (PolyUSD, 1:1 backed by USDC.e). If your wallet holds USDC.e, migrate at simmer.markets/dashboard with one click (~30s)
• If you bridged native USDC (Circle), swap to USDC.e first, then migrate to pUSD
• Full migration guide: docs.simmer.markets/v2-migration