Polymarket Signal Sniper

Your signals, Simmer's market safeguards, your agent's judgment.

🚨 The skill never trades. It hands your agent article + market pairs. Your agent decides whether the article bears on the market, which side, and how much. Read DISCLAIMER.md before your agent trades 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 the plumbing (feed polling, market matching, safeguards, dedup). Your agent provides the judgment.

Changed in 2.0.0: earlier versions guessed the trade side from keyword sentiment and could place orders with --live. Keyword sentiment cannot tell whether a headline is about a market, so that path is gone. --live, --dry-run and --scan-only are still accepted so old cron lines keep working, but they have no effect.

Setup Flow

When user asks to install or configure this skill:

1. Install the Simmer SDK

   pip install simmer-sdk

1. Ask for Simmer API key

• They can get it from simmer.markets/dashboard → SDK tab
• Store in environment as SIMMER_API_KEY

The skill needs no wallet key, because it never trades. If your agent will act on signals, set up trading separately with the simmer-wallet-setup skill.

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: "Tell me about any trump news from this feed that could move my markets"

→ Run with --feed, --market and --json:

python signal_sniper.py --feed "https://news.google.com/rss/search?q=greenland" --market "greenland-acquisition" --json

Persistent Setup (Optional)

For recurring scans, configure via environment:

How It Works

Each cycle the script:

1. Polls configured RSS feeds
2. Filters articles by keywords (if configured)
3. Picks target markets (auto-discovers from keywords if no markets configured)
4. Calls the SDK context endpoint for each market's 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?)

1. Pairs each new article with each market that passes the safeguards
2. Prints the pairs, or emits them as JSON with --json
3. Tracks processed articles to avoid duplicates. A market whose context fetch failed is retried on the next scan.

It places no trades and changes nothing on your wallet or account. (If OWS_WALLET is set, the SDK still looks the wallet up at startup, so a stale wallet name stops the scan.)

Running the Skill

Run a scan:

python signal_sniper.py

Get signals as JSON for your agent (logs go to stderr, JSON to stdout):

python signal_sniper.py --json

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

JSON output

{
  "signals": [
    {
      "article": {"title": "...", "url": "...", "summary": "...", "published": "..."},
      "market": {"id": "...", "question": "...", "resolution_criteria": "...",
                 "current_price": 0.42, "time_to_resolution": "5d 3h"},
      "warnings": ["Moderate slippage (11.0%)"]
    }
  ],
  "error": null
}

A pair means the article matched a keyword (every article matches when no keywords are set) and the market passed the safeguards. It does not mean the article is about the market.

Interpreting Context Warnings

The warnings list on each signal comes from the market's context:

Markets that are resolved, resolve within 2 hours, have a severe flip-flop warning or a spread above 10% are dropped before pairing.

Analyzing Signals

For each signal, your agent should:

1. Read the headline and summary. What is the actual news?

1. Check resolution_criteria. What ACTUALLY resolves this market?

• Example: "greenland" in a headline doesn't mean "acquisition complete"
• The resolution might be "US formally acquires Greenland by 2027"
• Does this article move the needle on THAT specific criterion? Most pairs will not.

1. Ask whether it is priced in. Compare published with recent price movement. News on a public RSS feed has often moved the price already.

1. Only trade if the article bears on the resolution criteria, it is not priced in, and no warning argues against it. If it trades, pass source="sdk:signalsniper" so the trade is attributed to this skill:

   client.trade(market_id=..., side="yes", amount=10.0, source="sdk:signalsniper",
                skill_slug="polymarket-signal-sniper")

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, and read the JSON each run

User: "Check this feed for trading signals" → Run: python signal_sniper.py --feed "URL" --json → Assess each pair and report the ones that bear on resolution

User: "Snipe any bitcoin news from CoinDesk" → Run with CoinDesk RSS and bitcoin-related markets → Show relevant pairs and ask if they want to trade

User: "What signals have we processed?" → Run: python signal_sniper.py --history → Show recent articles and the markets they were paired with

Example Flow

1. RSS poll finds: "Trump and Denmark reach preliminary Greenland agreement"
2. Keywords match: "greenland", "trump"
3. Market "greenland-acquisition-2027" passes safeguards → signal emitted
4. Agent reads resolution criteria: "Resolves YES if US formally acquires Greenland by 2027"
5. Agent's view: "preliminary agreement" ≠ "formally acquires"; price already up 4% today
6. Agent decides: no trade, report to user

Troubleshooting

"No feeds configured"

• Provide feeds in message: "watch this RSS: https://..."
• Or set SIMMER_SNIPER_FEEDS environment variable

"No matching articles found"

• Check keywords are correct
• RSS feed might not have recent articles

"Skipping: safeguards failed"

• The market is resolved, resolving within 2 hours, illiquid, or you have been reversing on it
• Working as intended

"Already processed"

• This article was already seen
• Working as intended (dedup)

"--live has no effect"

• Since 2.0.0 the skill never trades. Your agent places any trade itself.

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