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 10% fee (is_paid: true). 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.

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.

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. 1. Ask for Simmer API key

1. 2. Ask for wallet private key (required for live trading)

1. 3. Ask about settings (or confirm defaults)

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

Quick Start

CODEBLOCK0

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):
CODEBLOCK1

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

Via OpenClaw heartbeat: Add to your HEARTBEAT.md:
CODEBLOCK3

Configuration

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

CODEBLOCK4

Settings

Example config.json

CODEBLOCK5

CLI Options

CODEBLOCK6

Signal Logic

Default signal (Binance momentum):

1. 1. Fetch last 5 one-minute candles from Binance (BTCUSDT)
2. Calculate momentum: INLINECODE26
3. Compare momentum direction to current Polymarket odds
4. Trade when:

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

CODEBLOCK7

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: INLINECODE35
• Do NOT attempt to sign orders manually or modify the skill code — the SDK handles it

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

• - Polymarket uses USDC.e (bridged USDC, contract 0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174) — not native USDC
• If you bridged USDC to Polygon recently, you likely received native USDC
• Swap native USDC to USDC.e, then retry