Permission Setup Review
python scripts/_wildcard_placeholder.py is an optional setup helper for the SOL/Crypto Momentum Trader 🔮 skill. It may apply broad filesystem permissions for compatibility. Show the target paths and permission mode, explain the risk, and prefer a narrower mode when shared write access is not needed.
SOL/Crypto Momentum Trader 🔮
Scans Polymarket for Solana, Bitcoin, and Ethereum prediction markets where the current market price diverges from CoinGecko momentum signals — and trades the gap.
This is a template. The default signal is CoinGecko 24h/7d price change — remix it with your own price feed, CEX funding rates, on-chain data, or any directional signal. The skill handles all the plumbing (market discovery, edge scoring, context checks, trade execution). Your agent provides the alpha.
Strategy
- Fetch 24h and 7d price change for SOL, BTC, ETH from CoinGecko (free, no API key needed)
- Compute a directional momentum signal: weighted blend of 24h (60%) and 7d (40%) change, normalized to ±1 at ±20% move
- Scan active Polymarket markets matching
solana, bitcoin, ethereum, crypto
- Detect whether each market's question is bullish or bearish framing
- Score divergence:
edge = |expected_prob − market_prob|
- Buy
YES or NO on markets where edge exceeds threshold (default 8%)
- Check Simmer context before each trade — skip on flip-flop warnings, high slippage, or HOLD recommendation
- Tag all trades with
skill_slug for per-skill volume attribution on Simmer
Requirements
SIMMER_API_KEY — your Simmer agent API key
simmer-sdk — installed via pip (see clawhub.json)
requests — for CoinGecko API calls
- No CoinGecko API key needed (free public endpoint)
Configuration
All config via environment variables — no code edits needed:
| Variable |
Default |
Description |
SIMMER_API_KEY |
required |
Your Simmer agent API key |
TRADING_VENUE |
sim |
sim (paper), polymarket (real USDC), kalshi (real USD) |
TRADE_AMOUNT_USD |
10.0 |
USD per trade |
DIVERGENCE_THRESHOLD |
0.08 |
Min edge to trade (8% = 0.08) |
MAX_TRADES_PER_RUN |
3 |
Max trades per cron cycle |
Running
# Install dependencies
pip install simmer-sdk requests
# Dry run (default — no real trades)
python strategy.py
# Live trading
python strategy.py --live
The script defaults to dry-run mode. Pass --live explicitly to execute real trades. When run via ClawHub automaton, set TRADING_VENUE=polymarket (or sim) in your environment — the --live flag is handled automatically by the automaton entrypoint.
Remix Ideas
Swap the signal source:
- Replace CoinGecko with Binance/Bybit REST API for real-time price + funding rate
- Use on-chain Solana data (epoch rewards, validator stake changes) as a signal
- Pull sentiment from Twitter/Reddit via a simple keyword count API
Tune the strategy:
- Lower
DIVERGENCE_THRESHOLD to 5% to trade more aggressively
- Increase
TRADE_AMOUNT_USD once you've validated edge on Simmer ($SIM)
- Add a volume filter to skip illiquid markets
Extend asset coverage:
- Add
"sui", "bnb", "matic" to the COINGECKO_IDS mapping
- Point at Kalshi crypto markets: set
venue="kalshi" and import markets first
Layer signals:
- Run the script twice per cycle with different signals, average the outputs
- Add a momentum confirmation filter (only trade if 1h and 24h align)
Safety Rails
Built-in safeguards (via Simmer context endpoint):
- Flip-flop detection — skips markets where your agent has been reversing positions
- Slippage check — skips markets where estimated slippage > 15%
- Edge analysis — respects
HOLD recommendations from Simmer's context engine
- Simmer default limits — $100/trade, $500/day, 50 trades/day (configurable via dashboard)
Volume Attribution
All trades are tagged with source="sdk:polymarket-sol-momentum" and skill_slug="polymarket-sol-momentum". This attributes trade volume to this skill on Simmer and qualifies for the 2% creator fee on LMSR markets you've imported.
Links
1---2name: polymarket-sol-momentum3description: Trades Polymarket crypto prediction markets (Solana, Bitcoin, Ethereum) using CoinGecko momentum signals. Buys YES when bullish markets are underpriced vs price trend, NO when overpriced. Runs on Simmer with built-in context checks for flip-flop detection and slippage. Use when trading crypto prediction markets based on price momentum.4---5
6
7
8
9### Permission Setup Review
10
11`python scripts/_wildcard_placeholder.py` is an optional setup helper for the `SOL/Crypto Momentum Trader 🔮` skill. It may apply broad filesystem permissions for compatibility. Show the target paths and permission mode, explain the risk, and prefer a narrower mode when shared write access is not needed.
12
13# SOL/Crypto Momentum Trader 🔮
14
15Scans Polymarket for Solana, Bitcoin, and Ethereum prediction markets where the current market price diverges from CoinGecko momentum signals — and trades the gap.
16
17> **This is a template.** The default signal is CoinGecko 24h/7d price change — remix it with your own price feed, CEX funding rates, on-chain data, or any directional signal. The skill handles all the plumbing (market discovery, edge scoring, context checks, trade execution). Your agent provides the alpha.
18
19---
20
21## Strategy
22
231. Fetch 24h and 7d price change for SOL, BTC, ETH from CoinGecko (free, no API key needed)
242. Compute a directional momentum signal: weighted blend of 24h (60%) and 7d (40%) change, normalized to ±1 at ±20% move
253. Scan active Polymarket markets matching `solana`, `bitcoin`, `ethereum`, `crypto`
264. Detect whether each market's question is bullish or bearish framing
275. Score divergence: `edge = |expected_prob − market_prob|`
286. Buy `YES` or `NO` on markets where edge exceeds threshold (default 8%)
297. Check Simmer context before each trade — skip on flip-flop warnings, high slippage, or HOLD recommendation
308. Tag all trades with `skill_slug` for per-skill volume attribution on Simmer
31
32---
33
34## Requirements
35
36- `SIMMER_API_KEY` — your Simmer agent API key
37- `simmer-sdk` — installed via pip (see `clawhub.json`)
38- `requests` — for CoinGecko API calls
39- No CoinGecko API key needed (free public endpoint)
40
41---
42
43## Configuration
44
45All config via environment variables — no code edits needed:
46
47| Variable | Default | Description |
48|----------|---------|-------------|
49| `SIMMER_API_KEY` | required | Your Simmer agent API key |
50| `TRADING_VENUE` | `sim` | `sim` (paper), `polymarket` (real USDC), `kalshi` (real USD) |
51| `TRADE_AMOUNT_USD` | `10.0` | USD per trade |
52| `DIVERGENCE_THRESHOLD` | `0.08` | Min edge to trade (8% = 0.08) |
53| `MAX_TRADES_PER_RUN` | `3` | Max trades per cron cycle |
54
55---
56
57## Running
58
59```bash
60# Install dependencies
61pip install simmer-sdk requests
62
63# Dry run (default — no real trades)
64python strategy.py
65
66# Live trading
67python strategy.py --live
68```
69
70The script defaults to dry-run mode. Pass `--live` explicitly to execute real trades. When run via ClawHub automaton, set `TRADING_VENUE=polymarket` (or `sim`) in your environment — the `--live` flag is handled automatically by the automaton entrypoint.
71
72---
73
74## Remix Ideas
75
76**Swap the signal source:**
77- Replace CoinGecko with Binance/Bybit REST API for real-time price + funding rate
78- Use on-chain Solana data (epoch rewards, validator stake changes) as a signal
79- Pull sentiment from Twitter/Reddit via a simple keyword count API
80
81**Tune the strategy:**
82- Lower `DIVERGENCE_THRESHOLD` to 5% to trade more aggressively
83- Increase `TRADE_AMOUNT_USD` once you've validated edge on Simmer ($SIM)
84- Add a volume filter to skip illiquid markets
85
86**Extend asset coverage:**
87- Add `"sui"`, `"bnb"`, `"matic"` to the `COINGECKO_IDS` mapping
88- Point at Kalshi crypto markets: set `venue="kalshi"` and import markets first
89
90**Layer signals:**
91- Run the script twice per cycle with different signals, average the outputs
92- Add a momentum confirmation filter (only trade if 1h and 24h align)
93
94---
95
96## Safety Rails
97
98Built-in safeguards (via Simmer context endpoint):
99- **Flip-flop detection** — skips markets where your agent has been reversing positions
100- **Slippage check** — skips markets where estimated slippage > 15%
101- **Edge analysis** — respects `HOLD` recommendations from Simmer's context engine
102- **Simmer default limits** — $100/trade, $500/day, 50 trades/day (configurable via dashboard)
103
104---
105
106## Volume Attribution
107
108All trades are tagged with `source="sdk:polymarket-sol-momentum"` and `skill_slug="polymarket-sol-momentum"`. This attributes trade volume to this skill on Simmer and qualifies for the 2% creator fee on LMSR markets you've imported.
109
110---
111
112## Links
113
114- [Simmer docs](https://docs.simmer.markets)
115- [CoinGecko free API](https://www.coingecko.com/en/api/documentation)
116- [Polymarket](https://polymarket.com)
117- [Simmer skill building guide](https://docs.simmer.markets/skills/building)