SpartanLabsXyz Polymarket Signal Sniper
Your signals, Simmer's trading intelligence.
🚨 Framework, not a production trading system. Read DISCLAIMER.md before connecting to a wallet with real funds.
This is a template. The default signal source is RSS feeds — remix it with any data source (APIs, webhooks, social media, custom scrapers). The skill handles all the plumbing (market matching, safeguards, trade execution). Your agent provides the alpha.
When to Use This Skill
Use this skill when the user wants to:
- Monitor RSS feeds for trading opportunities
- Trade on breaking news before markets react
- Configure their own signal sources and keywords
- Get Trading Agent-grade safeguards on their trades
Setup Flow
When user asks to install or configure this skill:
Install the Simmer SDK
pip install simmer-sdkAsk for Simmer API key
- They can get it from simmer.markets/dashboard → SDK tab
- Store in environment as
SIMMER_API_KEY
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
- Not needed for $SIM paper trading on the Simmer venue
Quick Commands
# Check account balance and positions
python scripts/status.py
# Detailed position list
python scripts/status.py --positions
API Reference:
- Base URL:
https://api.simmer.markets - Auth:
Authorization: Bearer $SIMMER_API_KEY - Portfolio:
GET /api/sdk/portfolio - Positions:
GET /api/sdk/positions
Quick Start (Ad-Hoc Usage)
User provides RSS feed and market directly:
User: "Watch this RSS feed for greenland news: https://news.google.com/rss/search?q=greenland"
User: "Snipe any news about trump from this feed"
→ Run with --feed and --market flags:
python signal_sniper.py --feed "https://news.google.com/rss/search?q=greenland" --market "greenland-acquisition" --dry-run
Persistent Setup (Optional)
For automated recurring scans, configure via environment:
| Setting | Environment Variable | Default | Description |
|---|---|---|---|
| RSS Feeds | SIMMER_SNIPER_FEEDS |
(none) | Comma-separated RSS URLs |
| Markets | SIMMER_SNIPER_MARKETS |
(auto) | Comma-separated market IDs (auto-discovers from keywords if empty) |
| Keywords | SIMMER_SNIPER_KEYWORDS |
(none) | Comma-separated keywords to match |
| Confidence | SIMMER_SNIPER_CONFIDENCE_THRESHOLD |
0.7 | Min confidence to trade (0.0-1.0) |
| Max USD | SIMMER_SNIPER_MAX_USD |
25 | Max per trade |
| Max trades/run | SIMMER_SNIPER_MAX_TRADES_PER_RUN |
5 | Maximum trades per scan cycle |
Polymarket Constraints:
- Minimum 5 shares per order
- Trades below this threshold are rejected with an error message
How It Works
Each cycle the script:
- Polls configured RSS feeds
- Filters articles by keywords (if configured)
- Matches articles to target markets (auto-discovers from keywords if no markets configured)
- For each match, calls SDK context endpoint for safeguards:
- Position awareness (already holding?)
- Flip-flop detection (recently changed direction?)
- Slippage estimates (is market liquid?)
- Time decay (resolving soon?)
- Resolution criteria (what actually resolves this market?)
- If safeguards pass, infers trade direction from article sentiment
- Executes trade via SDK (with max trades per run cap)
- Tracks processed articles to avoid duplicates
Running the Skill
Run a scan (dry run by default — no trades):
python signal_sniper.py
Execute real trades:
python signal_sniper.py --live
Check for signals without trading:
python signal_sniper.py --scan-only
View current config:
python signal_sniper.py --config
Override for one run:
python signal_sniper.py --feed "https://..." --keywords "trump,greenland" --market "abc123"
Show processed articles:
python signal_sniper.py --history
Interpreting Context Warnings
Before trading, ALWAYS check the context warnings. The skill will show you:
| Warning | Action |
|---|---|
MARKET RESOLVED |
Do NOT trade |
HIGH URGENCY: Resolves in Xh |
Consider if signal is timely enough |
flip_flop_warning: SEVERE |
Skip - you've been reversing too much |
flip_flop_warning: CAUTION |
Proceed carefully, need strong signal |
Wide spread (X%) |
Reduce position size or skip |
Simmer AI signal: X% more bullish/bearish |
Consider Simmer's oracle opinion |
Analyzing Signals
When you find a matching article, analyze it carefully:
Read the headline and summary - What is the actual news?
Check resolution_criteria - What ACTUALLY resolves this market?
- Example: "greenland" in headline doesn't mean "acquisition complete"
- The resolution might be "US formally acquires Greenland by 2027"
- Does this signal move the needle on THAT specific criteria?
Assess confidence (0.0-1.0):
- How directly does this signal relate to resolution criteria?
- Is the source credible?
- Is this news likely already priced in?
Only trade if:
- Confidence > threshold (default 0.7)
- No severe warnings
- Signal validates against resolution criteria
Example Conversations
User: "Set up news sniping for the Greenland market" → Ask for RSS feeds they want to monitor → Configure with market ID and keywords → Enable cron for recurring scans
User: "Check this feed for trading signals"
→ Run: python signal_sniper.py --feed "URL" --scan-only
→ Show found articles and potential matches
User: "Snipe any bitcoin news from CoinDesk" → Run with CoinDesk RSS and bitcoin-related markets → Show matches and ask if they want to trade
User: "What signals have we processed?"
→ Run: python signal_sniper.py --history
→ Show recent articles and actions taken
Example Trade Flow
1. RSS poll finds: "Trump and Denmark reach preliminary Greenland agreement"
2. Keywords match: "greenland", "trump"
3. Call context endpoint for market "greenland-acquisition-2027"
4. Check warnings: none severe ✓
5. Resolution criteria: "Resolves YES if US formally acquires Greenland by 2027"
6. You analyze: "preliminary agreement" ≠ "formally acquires" but bullish signal
7. Confidence: 0.75 (positive indicator, not definitive)
8. Check slippage: 2.5% on $25 ✓
9. Execute: BUY YES $25
10. Report: "🎯 Sniped: Trump/Greenland agreement → BUY YES $25"
Troubleshooting
"No feeds configured"
- Provide feeds in message: "watch this RSS: https://..."
- Or set
SIMMER_SNIPER_FEEDSenvironment variable
"No matching articles found"
- Check keywords are correct
- RSS feed might not have recent articles
- Try
--scan-onlyto see what's in the feed
"Skipped due to flip-flop warning"
- You've been changing direction too much on this market
- Wait before trading again, or find new information
"Slippage too high"
- Market is illiquid
- Reduce trade size or skip
"Already processed"
- This article was already seen
- Working as intended (dedup)
"External wallet requires a pre-signed order"
WALLET_PRIVATE_KEYis 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
Finding Good RSS Feeds
Tips for choosing signal sources:
- Google News RSS:
https://news.google.com/rss/search?q=YOUR_TOPIC - Niche sources: Better than mainstream (less priced in)
- Official sources: Government, company announcements
- Twitter lists → RSS: Use services like Nitter or RSS.app
The skill works best when:
- Feeds are relevant to your target markets
- You have specific keywords to filter noise
- Sources publish before mainstream coverage