← Back to Skills Marketplace
oryselias

Polymarket Fast Loop Improved

by oryselias · GitHub ↗ · v0.1.0
cross-platform ⚠ suspicious
630
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install fastloop
Description
Trade Polymarket BTC/ETH/SOL 5-minute and 15-minute fast markets using multi-signal CEX momentum. Adds funding rate confirmation, order book imbalance, time-...
README (SKILL.md)

Polymarket FastLoop Trader — Improved

An enhanced version of the Simmer FastLoop skill with rigorous edge filtering, multi-signal confirmation, and real calibration tracking.

Default is paper mode. Use --live for real trades. Always run 100+ paper trades first to validate your win rate before going live.

⚠️ Fast markets carry Polymarket's 10% fee. Your signal needs to be right 63%+ of the time to profit. This skill will tell you your actual win rate.

Key Improvements Over Original

Feature Original Improved
Fee math Approximate Exact breakeven with configurable buffer
Signal Binance momentum only Momentum + funding rate + order book
Momentum threshold 0.5% (too low) 1.0% default, calibration-driven
Time filtering None Skips low-liquidity hours
Position sizing Fixed Volatility-adjusted
Win rate tracking None Logs outcomes, reports calibration
Market selection Soonest expiry Configurable sweet-spot window
Stats None Full P&L, win rate, signal breakdown

Quick Start

# Install dependency
pip install simmer-sdk

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

# Paper mode — see what would happen (default)
python fastloop_improved.py

# Go live
python fastloop_improved.py --live

# Check calibration stats (win rate, P&L, signal accuracy)
python fastloop_improved.py --stats

# Resolve any expired paper trades against real outcomes
python fastloop_improved.py --resolve

# Quiet mode for cron
python fastloop_improved.py --live --quiet

How to Run on a Loop

OpenClaw native cron:

openclaw cron add \
  --name "FastLoop Improved" \
  --cron "*/5 * * * *" \
  --tz "UTC" \
  --session isolated \
  --message "Run improved fast loop: cd /path/to/skill && python fastloop_improved.py --live --quiet. Show output summary." \
  --announce

Linux crontab:

*/5 * * * * cd /path/to/skill && python fastloop_improved.py --live --quiet

Configuration

# Raise momentum threshold (recommended: 1.0–2.0%)
python fastloop_improved.py --set min_momentum_pct=1.5

# Require order book confirmation
python fastloop_improved.py --set require_orderbook=true

# Set sweet-spot window for market selection (seconds remaining)
python fastloop_improved.py --set target_time_min=90 --set target_time_max=180

# Disable time-of-day filter (trade 24/7)
python fastloop_improved.py --set time_filter=false

All Settings

Setting Default Description
entry_threshold 0.05 Min divergence from 50¢
min_momentum_pct 1.0 Min % BTC move (raised from 0.5)
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 less than 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_funding false Require funding rate confirmation
require_orderbook false Require order book imbalance confirmation
time_filter true Skip low-liquidity hours (02:00–06:00 UTC)
vol_sizing true Adjust size by recent volatility
fee_buffer 0.05 Extra edge required above fee breakeven
daily_budget 10.0 Max spend per UTC day
starting_balance 1000.0 Paper portfolio starting balance

Signal Logic

Three signals are evaluated independently. The momentum signal is always required. Funding and order book are optional confirmation layers.

1. Momentum (always on)

  • Fetch N one-minute Binance candles
  • momentum = (close_now - open_then) / open_then * 100
  • Must exceed min_momentum_pct

2. Funding Rate (optional, require_funding=true)

  • Fetch Binance perpetual funding rate for the asset
  • Positive funding + upward momentum = longs crowded, signal is weaker → SKIP
  • Negative funding + upward momentum = confirmation → TRADE
  • Logic inverted for downward momentum

3. Order Book Imbalance (optional, require_orderbook=true)

  • Fetch top 20 levels of Binance L2 book
  • imbalance = (bid_depth - ask_depth) / (bid_depth + ask_depth)
  • Imbalance > 0.1 confirms upward momentum
  • Imbalance \x3C -0.1 confirms downward momentum

Fee-Accurate EV

entry_price  = market price of chosen side
win_profit   = (1 - entry_price) × (1 - fee_rate)
breakeven    = entry_price / (win_profit + entry_price)
required_div = (breakeven - 0.50) + fee_buffer

Trade only fires if actual_divergence ≥ required_div.

Time-of-Day Filter

Skips 02:00–06:00 UTC by default. US session (13:00–21:00 UTC) is the highest-liquidity window for crypto prediction markets.

Volatility-Adjusted Sizing

24h_vol = std(hourly_returns_last_24h) × √24
size    = max_position × min(1.0, 0.02 / 24h_vol)

High volatility → smaller position. Low volatility with strong trend → full size.

Win Rate Calibration

The skill tracks every paper and live trade in fastloop_ledger.json. After market expiry, run --resolve to fetch the actual Polymarket outcome and log it. After 50+ trades, --stats shows your real win rate broken down by momentum threshold, time of day, and asset — so you can tune settings based on actual data rather than guessing.

Troubleshooting

All troubleshooting from the original skill applies. Additional:

"Funding rate fetch failed"

  • Binance futures API may be rate-limited. Skill falls back to momentum-only.

"Order book imbalance: neutral"

  • Market is balanced, signal is ambiguous — skipped if require_orderbook=true.

"Time filter: low liquidity window"

  • Current UTC hour is in the 02–06 block. Set time_filter=false to override.
Usage Guidance
Do not install or run this skill until you verify provenance and code. Key points to check before use: - The skill package contains only instructions but references fastloop_improved.py as the runtime entrypoint; ask the publisher where that script comes from. Running an unknown script is risky. - Verify exactly what permissions SIMMER_API_KEY grants in simmer-sdk (trading-only vs withdrawals/config). Use a least-privilege test key if possible. - Start in paper mode only and run many automated paper trades (as the doc suggests) before any --live runs. Monitor outcomes and logs. - The skill writes fastloop_ledger.json locally — ensure you’re comfortable with trade history being stored in that file and its location/permissions. - Be cautious about scheduling autonomous runs (cron/automaton). Autonomous trading combined with a live-capable API key can cause financial loss if misconfigured or malicious. - Confirm the simmer-sdk package on PyPI is the official package and review its docs and permissions. Consider running the skill inside an isolated environment or VM and inspect any code before granting keys. If you cannot verify the script origin or the key permissions, treat this skill as untrusted.
Capability Analysis
Type: OpenClaw Skill Name: fastloop Version: 0.1.0 The skill is classified as suspicious primarily due to the reliance on an external API key (`SIMMER_API_KEY`) and the execution of an unprovided Python script (`fastloop_improved.py`) which is declared as the entry point. While the `SKILL.md` file outlines a plausible purpose for a trading bot (accessing market data, making trades), the absence of the actual Python code means its handling of the API key, network interactions, and overall execution cannot be verified for vulnerabilities or unintended behaviors. The `SKILL.md` also contains a benign prompt injection attempt (`Show output summary`) within the cron job instructions, highlighting the agent's susceptibility to instructions in markdown, though this specific instance is not malicious.
Capability Assessment
Purpose & Capability
The skill claims to trade Polymarket fast markets and asks only for SIMMER_API_KEY (used by the simmer-sdk); that is plausible if the simmer service brokers Polymarket trades. It also relies on public Binance market data (candles, funding, L2 book) which typically don't require API keys. However, the SKILL metadata declares an entrypoint (fastloop_improved.py) and a pip dependency (simmer-sdk) but the skill bundle contains no code files — a mismatch between claimed runtime and what is bundled.
Instruction Scope
The instructions tell the agent/user to pip install simmer-sdk, export SIMMER_API_KEY, run python fastloop_improved.py (paper by default, --live for real trades), and read/write a local ledger (fastloop_ledger.json). They also provide cron examples to run every 5 minutes. The instructions remain within the trading domain, but they assume a local Python script that is not included, and they direct filesystem writes and network access to external services for trading — including the possibility of live (real-money) trades.
Install Mechanism
There is no install spec from the registry and no files are written by the skill itself. The SKILL.md recommends 'pip install simmer-sdk' which is a normal package install. Because the skill is instruction-only, there is low direct install risk from the registry, but running the recommended pip install and executing external scripts (not provided) introduces runtime risk under user control.
Credentials
Only SIMMER_API_KEY is required which is proportionate to a brokered trading skill. However, the evaluator cannot confirm what permissions that key grants (trading only vs. transfers/withdrawals/config changes). The SKILL.md does not request or document any Polymarket-specific keys or Binance keys — plausible if simmer-sdk abstracts access — but the lack of explicit permission guidance is a concern.
Persistence & Privilege
The skill is not marked 'always:true' and defaults to requiring invocation. Metadata shows an automaton entrypoint (managed=true) which implies it can be scheduled/managed by the platform if the entrypoint exists. Combined with the ability to run live trades via SIMMER_API_KEY, autonomous invocation or cron usage increases the operational risk. The bundle itself does not persist additional system-wide configurations.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install fastloop
  3. After installation, invoke the skill by name or use /fastloop
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.0
Polymarket FastLoop Trader (Improved) — v1.0.0 - Adds multi-signal edge filtering: momentum, funding rate, and order book imbalance confirmations. - Implements exact, fee-accurate EV math and volatility-adjusted position sizing. - Introduces real-time win-rate tracking, calibration stats, and a comprehensive P&L log. - Skips trades during low-liquidity UTC hours and supports time-sweet-spot market selection. - Fully configurable via command-line settings; defaults to safe paper mode. - Extensive documentation and usage instructions provided in SKILL.md.
Metadata
Slug fastloop
Version 0.1.0
License
All-time Installs 1
Active Installs 1
Total Versions 1
Frequently Asked Questions

What is Polymarket Fast Loop Improved?

Trade Polymarket BTC/ETH/SOL 5-minute and 15-minute fast markets using multi-signal CEX momentum. Adds funding rate confirmation, order book imbalance, time-... It is an AI Agent Skill for Claude Code / OpenClaw, with 630 downloads so far.

How do I install Polymarket Fast Loop Improved?

Run "/install fastloop" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Polymarket Fast Loop Improved free?

Yes, Polymarket Fast Loop Improved is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Polymarket Fast Loop Improved support?

Polymarket Fast Loop Improved is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Polymarket Fast Loop Improved?

It is built and maintained by oryselias (@oryselias); the current version is v0.1.0.

💬 Comments