← Back to Skills Marketplace
adlai88

Polymarket Signal Sniper

by AD88 · GitHub ↗ · v1.5.2 · MIT-0
cross-platform ⚠ suspicious
1563
Downloads
0
Stars
11
Active Installs
20
Versions
Install in OpenClaw
/install polymarket-signal-sniper
Description
Snipe Polymarket opportunities from your own signal sources. Monitors RSS feeds with Trading Agent-grade safeguards.
Usage Guidance
What to check before installing or enabling this skill: - Metadata mismatch: The registry summary reported no required env vars, but the skill package (clawhub.json and SKILL.md) requires SIMMER_API_KEY and optionally WALLET_PRIVATE_KEY. Confirm which is authoritative before trusting the listing. - Sensitive secrets: This skill supports placing real trades. If you provide WALLET_PRIVATE_KEY (private key), the SDK will sign orders automatically. Prefer using a managed custodial wallet or a limited-scope API key rather than putting an unlocked private key in an environment variable. If you must use a private key, keep it in a secure secret store and rotate it frequently. - Autonomy and safeguards: The code is capable of making live trades. If you don't want autonomous actions, do not run with --live or set up the skill to run automatically, or disable autonomous model invocation/automaton features in your agent. Run in dry-run/scan-only mode first and verify behavior. - Confirm the SDK: Inspect the simmer-sdk package (its source and release channel) before installation. Ensure the package version matches expectations (clawhub.json requests simmer-sdk>=0.11.1). Verify simmer.markets is the legitimate service you intend to use. - Env var and tunable mismatches: The skill's SKILL.md, code, and clawhub.json use slightly different names for some environment variables/tunables. If you set an env var and the skill doesn't see it, it may default to different values. Review the code or run --config to confirm active settings. - Least privilege: Use the smallest API key permissions possible and limit MAX_USD/MAX_TRADES while testing. Consider network isolation/sandbox execution when trialing. - Files written locally: The skill writes a state/processed.json file in its directory. If you run this in a shared environment, ensure the directory's access permissions meet your security needs. If you want a higher-confidence assessment, provide: - The simmer-sdk package source or a link to its official repo/release so I can check what the SDK does when given credentials; and - Clarification which registry metadata (the summary shown vs clawhub.json) is the authoritative manifest so the declared requirements can be reconciled.
Capability Analysis
Type: OpenClaw Skill Name: polymarket-signal-sniper Version: 1.5.2 The skill is a legitimate trading tool for Polymarket that monitors RSS feeds for signals and executes trades via the Simmer SDK. It includes robust features such as SSRF protection for external requests in signal_sniper.py, file locking for state management, and clear instructions in SKILL.md for the AI agent to handle sensitive credentials (like the WALLET_PRIVATE_KEY) securely via environment variables. The code is well-structured, follows security best practices like atomic file writes and XXE protection attempts, and lacks any indicators of malicious intent or data exfiltration.
Capability Tags
cryptorequires-walletrequires-sensitive-credentials
Capability Assessment
Purpose & Capability
The code and SKILL.md implement an RSS-based signal watcher that uses the simmer-sdk to call Simmer API and execute trades — this matches the 'Polymarket Signal Sniper' description. However the registry summary shown earlier (no required env vars / no primary credential) contradicts clawhub.json and the SKILL.md, both of which declare SIMMER_API_KEY as required and document WALLET_PRIVATE_KEY as an optional but highly sensitive credential.
Instruction Scope
The runtime instructions explicitly ask the user to install simmer-sdk, set SIMMER_API_KEY, and optionally put a wallet private key in the environment so the SDK can sign trades client-side. The skill's code polls RSS feeds, matches to markets, calls SDK 'context/safeguards' endpoints, and can execute live trades. That scope is consistent with the stated purpose but gives the skill (and the SDK it loads) the ability to autonomously place orders if run with live credentials — a high-impact capability that users must consciously enable.
Install Mechanism
No custom download/install step is embedded in the skill; the SKILL.md instructs pip install simmer-sdk and clawhub.json lists simmer-sdk in pip requirements. That's a standard package install path. There are no obscure URLs or archive-extract installs in the manifest.
Credentials
Requiring SIMMER_API_KEY is proportional to a client that calls Simmer's API. The skill also asks for WALLET_PRIVATE_KEY (optional) for self-custody trading; that is expected for direct on-chain/order signing but is very sensitive. There are multiple small inconsistencies in env var names between SKILL.md, code, and clawhub.json (e.g., SIMMER_SNIPER_CONFIDENCE vs SIMMER_SNIPER_CONFIDENCE_THRESHOLD, SIMMER_SNIPER_MAX_TRADES vs SIMMER_SNIPER_MAX_TRADES_PER_RUN), and the code also reads other envs like TRADING_VENUE and AUTOMATON_MAX_BET that aren't clearly declared in top-level metadata — these mismatches reduce transparency about what secrets/config are required.
Persistence & Privilege
The skill is not marked always:true, and autostart is false, but clawhub.json marks the automaton as managed with an entrypoint of signal_sniper.py, and the skill is written to persist state (state/processed.json) and can update its own config via simmer_sdk.skill helpers. Combined with the ability to use a wallet private key and the default of allowing autonomous model invocation, this creates a realistic path for automated live trades if credentials are present — a high-privilege action that users should consciously authorize.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install polymarket-signal-sniper
  3. After installation, invoke the skill by name or use /polymarket-signal-sniper
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.5.2
- Update to version 1.5.2 with minor maintenance changes. - Updated version metadata in SKILL.md. - Updated configuration in clawhub.json. - No changes to core functionality or CLI.
v1.5.1
V2 migration (2026-04-28): updated troubleshooting copy to point users at the Wrap USDC.e → pUSD flow at simmer.markets/dashboard + docs.simmer.markets/v2-migration. Also refines clawhub.json envVars schema (WALLET_PRIVATE_KEY now correctly optional for managed-wallet users).
v1.4.7
Schema fix: primaryEnv + envVars with required:false for optional credentials. Clears OpenClaw 'disproportionate requirements' verdict.
v1.4.6
Declare WALLET_PRIVATE_KEY in requires.env for OpenClaw moderation alignment.
v1.4.5
Add Setup Flow section with pip install simmer-sdk
v1.4.4
Add auto_redeem() call at start of each cycle for external wallet support
v1.4.3
Polymarket Signal Sniper v1.4.3 - Added support for configuration via config.json file. - Introduced state tracking of processed signals using state/processed.json to prevent duplicate actions. - Updated signal_sniper.py for integration with new config and state files.
v1.4.2
- Bug fix release improving reliability in signal_sniper.py - Minor code adjustments; no changes to SKILL.md or user-facing functionality - Version bump to 1.4.2
v1.4.1
Polymarket Signal Sniper 1.4.1 - Updated version metadata in SKILL.md to 1.4.0. - Minor documentation and metadata consistency updates.
v1.4.0
Fix: add missing skill_slug param to execute_trade — was crashing on real trade execution
v1.3.12
AgentSkills format — moved platform config to clawhub.json for cross-agent compatibility
v1.3.11
- Added "difficulty: intermediate" metadata to SKILL.md. - No other functional or user-facing changes included in this version.
v1.3.10
Version 1.3.10 - Updated core logic in signal_sniper.py (details not specified) - No user-facing documentation or configuration changes - Maintains existing features for RSS signal trading on Polymarket
v1.3.9
Add is_live_now filter for not-yet-open market guard
v1.3.8
**Adds managed automaton mode and improves market discovery** - Added metadata for automaton management and specified entrypoint (signal_sniper.py) to enable managed/automated operation. - Auto-discovers markets from keywords if no specific markets configured, making setup easier. - Updated environment variable documentation to reflect new auto-discovery behavior. - Minor version bump and documentation updates.
v1.3.7
- Updated documentation to remove `WALLET_PRIVATE_KEY` as a required environment variable in metadata. - Version bump from 1.3.5 to 1.3.6. - No logic or feature changes; documentation/metadata update only.
v1.3.6
- Added troubleshooting guidance for "Balance shows $0 but I have USDC on Polygon," clarifying the difference between USDC.e and native USDC on the platform. - No other changes to functionality or features.
v1.3.5
- Adds support for `WALLET_PRIVATE_KEY` as a required environment variable for order signing. - Updates documentation to clarify SDK handles signing and eliminates need for manual signature code. - Provides troubleshooting guidance for external wallet signing errors. - Bumps version to 1.3.5.
v1.3.4
- Added simmer-sdk to required pip dependencies in SKILL.md metadata. - Updated version to 1.3.4. - Added a template note in the documentation encouraging users to remix the skill with different data sources, not just RSS feeds.
v1.3.3
Polymarket Signal Sniper v1.3.3 - Clarified setup and usage instructions for both ad-hoc and persistent monitoring of trading signals via RSS feeds. - Expanded examples for common user scenarios and signal analysis, making it easier to interpret context warnings and trade safely. - Provided detailed troubleshooting guidance and best practices for feed selection. - Documented environment variables and command-line options for comprehensive configuration. - Outlined safeguards and trade logic, including position awareness, flip-flop detection, slippage, and market resolution criteria.
Metadata
Slug polymarket-signal-sniper
Version 1.5.2
License MIT-0
All-time Installs 11
Active Installs 11
Total Versions 20
Frequently Asked Questions

What is Polymarket Signal Sniper?

Snipe Polymarket opportunities from your own signal sources. Monitors RSS feeds with Trading Agent-grade safeguards. It is an AI Agent Skill for Claude Code / OpenClaw, with 1563 downloads so far.

How do I install Polymarket Signal Sniper?

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

Is Polymarket Signal Sniper free?

Yes, Polymarket Signal Sniper is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Polymarket Signal Sniper support?

Polymarket Signal Sniper is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Polymarket Signal Sniper?

It is built and maintained by AD88 (@adlai88); the current version is v1.5.2.

💬 Comments