← Back to Skills Marketplace
wyzmf

Polymarket Scanner

by wyzmf · GitHub ↗ · v1.0.0
cross-platform ✓ Security Clean
323
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install polymarket-scanner
Description
Automated Polymarket prediction market scanner and trader via Simmer API. Use when analyzing prediction markets, scanning for trading opportunities, executin...
Usage Guidance
This skill is internally consistent with its stated purpose and only needs your SIMMER_API_KEY, but review and test before letting it trade real funds. Important points: - The code will automatically call the Simmer trade endpoint for qualifying opportunities; it does not implement an explicit human confirmation step for real (USDC) trades despite the SKILL.md claiming one — if you plan to trade real money, modify the script to require manual approval or double-check the agent's real_trading_enabled state before auto-executing. - Store SIMMER_API_KEY securely (do not paste into public logs). The script logs trade events to trading_log.jsonl in the parent directory — inspect or restrict that file if it will contain sensitive info. - The script supports optional SCANNER_* environment variables to tune behavior; consider setting conservative limits (lower trade_pct, lower max_trade) when testing. - Run first in a safe environment (e.g., with a test/virtual SIM account) to verify behavior and confirm it only trades as you expect. Given the financial risk, do not install or run this with live API keys until you have reviewed and (if needed) modified the automatic-trade behavior.
Capability Analysis
Type: OpenClaw Skill Name: polymarket-scanner Version: 1.0.0 The OpenClaw skill 'polymarket-scanner' is benign. It functions as a prediction market scanner and trader, interacting solely with the `https://api.simmer.markets` API as declared. The `scripts/scanner.py` retrieves the `SIMMER_API_KEY` from environment variables, performs API calls, and logs activity to a local `trading_log.jsonl` file. There is no evidence of data exfiltration to unauthorized endpoints, malicious execution, persistence mechanisms, or prompt injection attempts in `SKILL.md`.
Capability Assessment
Purpose & Capability
Name/description align with code: the script talks only to the Simmer API (agents/me, positions, markets/opportunities, context, trade) and requires a SIMMER_API_KEY. No unrelated services or binaries are requested.
Instruction Scope
SKILL.md claims safety controls like 'SIM auto, USDC manual' and 'Real USDC trades require human confirmation', but the scanner.py implementation will POST trade requests unconditionally for qualifying opportunities (it does not implement an explicit human confirmation step or a separate flow for virtual vs real trades). This creates a risk the agent will execute real-money trades contrary to the documentation.
Install Mechanism
No install spec; this is an instruction-only skill with a single Python script and no downloads or extracted archives. Lowest-risk install model.
Credentials
The SKILL.md documents only SIMMER_API_KEY as required, which matches the code. The script also reads several optional SCANNER_* env vars (SCANNER_MIN_SCORE, SCANNER_MIN_DIVERGENCE, SCANNER_MAX_POSITIONS, SCANNER_TRADE_PCT, SCANNER_MAX_TRADE, SCANNER_MIN_BALANCE, SCANNER_MAX_SPREAD) controlling thresholds — these are reasonable but not documented in SKILL.md. Only the Simmer API key is required; no unrelated credentials are requested.
Persistence & Privilege
always is false and the skill does not modify other skills or system settings. It writes a local trading_log.jsonl file (in the repository parent) for its own logs, which is expected behavior.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install polymarket-scanner
  3. After installation, invoke the skill by name or use /polymarket-scanner
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: auto-scan prediction markets via Simmer API, configurable trading rules, position management, JSONL logging
Metadata
Slug polymarket-scanner
Version 1.0.0
License
All-time Installs 1
Active Installs 1
Total Versions 1
Frequently Asked Questions

What is Polymarket Scanner?

Automated Polymarket prediction market scanner and trader via Simmer API. Use when analyzing prediction markets, scanning for trading opportunities, executin... It is an AI Agent Skill for Claude Code / OpenClaw, with 323 downloads so far.

How do I install Polymarket Scanner?

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

Is Polymarket Scanner free?

Yes, Polymarket Scanner is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Polymarket Scanner support?

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

Who created Polymarket Scanner?

It is built and maintained by wyzmf (@wyzmf); the current version is v1.0.0.

💬 Comments