Polymarket Market Importer

Auto-discover and import Polymarket markets matching your keywords, tags, and volume criteria. Runs on a schedule so you never miss a new market worth tradin...

Security Scan

The skill mostly does what it claims (imports Polymarket markets into Simmer) and uses the expected simmer-sdk, but there are metadata inconsistencies and packaging anomalies you should verify before running live.

Purpose & Capability

The code and SKILL.md clearly implement a Simmer-backed Polymarket importer and require SIMMER_API_KEY — that is coherent with the stated purpose. However the registry summary at the top of the evaluation indicated "Required env vars: none," while clawhub.json, SKILL.md, and market_importer.py all require SIMMER_API_KEY. Also the ownerId and version fields differ between the provided registry metadata and _meta.json/clawhub.json, which suggests packaging/metadata drift (repackaging or stale registry entry).

Instruction Scope

Runtime instructions (install simmer-sdk, set SIMMER_API_KEY, configure filters, run in dry-run then --live) match the code's behavior. The code only calls the simmer-sdk client methods (list_importable_markets, import_market), filters results, and persists seen market IDs. It does read an optional TRADING_VENUE env var and writes imported_markets.json in the skill directory — both are consistent with the importer purpose.

Install Mechanism

Installation is via pip (simmer-sdk) which is standard and expected. There is no download-from-URL or archive extraction in the package. The skill is instruction/code based with no additional installer, which is low-to-moderate risk and consistent with the declared dependency.

Credentials

The only secret needed is SIMMER_API_KEY, which is appropriate for a tool that interacts with the Simmer API. The concern is not the credential itself but the inconsistency between metadata listings (one place claims no required env vars while the code requires the API key). Confirm which metadata is authoritative before handing over a key.

Persistence & Privilege

The skill is not always-included and does not request elevated platform privileges. It persists a local file (imported_markets.json) for deduplication and config via simmer-sdk; it does not modify other skills or global agent settings. Cron scheduling is declared in clawhub.json (0 */6 * * *) but autostart is false.

What to consider before installing

This skill appears to implement the advertised importer and only needs your Simmer API key, but there are mismatches in the package metadata (required env vars, ownerId, and version). Before running with --live: 1) verify the publisher/owner and that clawhub.json/_meta.json match the repository you trust; 2) inspect simmer-sdk (the pip package) to confirm it is the official SDK you expect; 3) run a dry run (python market_importer.py) and review imported_markets.json location and contents; 4) store SIMMER_API_KEY in a safe place (not in plaintext cron jobs) and avoid passing it to untrusted copies of this skill; 5) only enable scheduled runs after you confirm the skill is from a trusted source and its metadata is consistent.

This is a template. The keywords, categories, and volume filters are yours to set. The skill handles the hunting — searching Polymarket on a schedule, filtering by your criteria, skipping what you've already seen, and importing the rest into Simmer. You configure the net, it catches the fish.

Setup

1. Install the SDK:

   pip install simmer-sdk
   

2. Set your API key:

   export SIMMER_API_KEY="sk_live_..."
   

3. Set your filters:

   python market_importer.py --set keywords=bitcoin,ethereum,solana
   python market_importer.py --set min_volume=25000
   

4. Dry run to verify:

   python market_importer.py
   

5. Go live:

   python market_importer.py --live
   

Configuration

Parameter	Env Var	Default	Description
keywords	IMPORTER_KEYWORDS	bitcoin,ethereum	Comma-separated search terms
min_volume	IMPORTER_MIN_VOLUME	10000	Minimum 24h volume — filters out thin markets
max_per_run	IMPORTER_MAX_PER_RUN	5	Cap on imports per execution
categories	IMPORTER_CATEGORIES	crypto	Comma-separated category filters (crypto, politics, sports, etc.)

Quick Commands

# Dry run — preview what would be imported
python market_importer.py

# Import for real
python market_importer.py --live

# Check what you've already imported
python market_importer.py --positions

# Show current config
python market_importer.py --config

# Update a setting
python market_importer.py --set keywords=bitcoin,ethereum,xrp

# Quiet mode — only output on imports or errors
python market_importer.py --live --quiet

Example Output

🎯 Polymarket Market Importer
==================================================

  [LIVE MODE] Importing markets for real.

  Config: keywords=bitcoin,ethereum | min_volume=10000 | max_per_run=5 | categories=crypto

  Searching for: bitcoin
    Found 12 importable markets
    3 already imported, 9 new
    Category match: 7

  Searching for: ethereum
    Found 8 importable markets
    2 already imported, 6 new
    Category match: 5

  Importing: "Will BTC exceed $150k by July 2026?" (vol: $125,000)
    ✅ Imported successfully
  Importing: "Will ETH reach $5k by June 2026?" (vol: $89,000)
    ✅ Imported successfully

  Summary: 20 found | 5 already seen | 2 imported (max 5)

Troubleshooting

Problem	Fix
"No importable markets found"	Broaden your keywords or lower min_volume
"Import failed"	Daily quota may be hit (10/day free, 50/day Pro). Try next run.
"SIMMER_API_KEY not set"	Get your key from simmer.markets/dashboard → SDK tab
Markets not matching categories	Category filter checks question text and tags. Try different terms.

Schedule

Runs every 6 hours via cron (0 */6 * * *). Adjust in clawhub.json if needed.