Polymarket Candle Momentum

Trade Polymarket 5-minute crypto fast markets using candle body analysis and volume surge detection from Binance. A stronger, data-driven alternative to simple momentum signals.

This is a template. The default signal uses Binance 1-minute candle structure (body/range ratio + volume surge). Remix it with your own thresholds, additional indicators, or alternative data sources. 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). The default thresholds are calibrated to maintain edge after fees.

The Signal

Most fast-market skills use simple price momentum (did price go up or down?). This skill looks at how price moved:

1. 1. Candle Body Ratio - Measures the last 1-minute candle's body size relative to its full range. A body ratio > 60% means a decisive move with minimal wicks (strong conviction, not noise).

1. 2. Volume Surge - Confirms the move with volume. The last candle's volume must be > 1.5x the average of the previous 3 candles. High volume + strong body = real move, not a fake-out.

1. 3. Direction Alignment - Body direction (bullish/bearish) must align with the 5-minute momentum direction.

Why This Works Better

Simple momentum catches every wiggle. Candle body analysis filters for quality moves:

• - A 0.5% move on a doji candle (long wicks, tiny body) = noise. Skip.
• A 0.3% move on a marubozu candle (90% body, no wicks) = conviction. Trade.

Backtested on BTC/ETH/SOL/XRP/BNB (3 months, 6131 five-minute slots):

• - body > 65% + volume > 1.5x: 86.3% win rate (N=292)
• INLINECODE2: 84.7% win rate (N=333)

Setup

pip dependencies: simmer-sdk, INLINECODE4

Environment variables:

• - SIMMER_API_KEY (required) - get from simmer.markets/dashboard

No other credentials needed. The script only reads SIMMER_API_KEY from the environment. All trades go through SimmerClient.trade() - no wallet private key, no direct CLOB access.

CODEBLOCK0

How to Run on a Loop

The script runs one cycle. Set up a cron (every 2 min recommended for 5min markets):

CODEBLOCK1

Security Notes

• - Only SIMMER_API_KEY is read from environment. Nothing else.
• No host files are read. No logs written outside the script's own stdout.
• INLINECODE9 is false - the skill does not auto-execute.
• Dry-run by default. --live must be passed explicitly.

Trade Execution Path

1. 1. Fetches Binance public klines (no auth) for BTC, ETH, SOL, XRP, BNB
2. Scans all 5 assets, picks strongest signal (bodyratio x volsurge score)
3. Finds matching Polymarket fast market via INLINECODE12
4. If --live: calls SimmerClient.trade() with side, amount, reasoning
5. If dry-run: logs the signal, no trade placed

Configuration

Via environment variables only (no local file persistence):

CODEBLOCK2

Settings

CLI Options

CODEBLOCK3

Remix Ideas

The candle body + volume signal is just the starting point. Ideas:

• - Multi-timeframe: Confirm 1m signal with 5m candle structure
• Wick analysis: Filter out candles with long upper wicks (rejection)
• RSI filter: Skip overbought/oversold conditions
• Multi-exchange: Compare candle patterns across Binance + Coinbase
• Order flow: Add Polymarket CLOB depth as confirmation

To customize, edit get_candle_signal() in candle_momentum.py.

Example Output

CODEBLOCK4

Source

All trades tagged with source: "sdk:candle-momentum" for portfolio tracking.