← Back to Skills Marketplace
simmer
by
Simmer.Markets
· GitHub ↗
· v1.25.1
· MIT-0
10389
Downloads
23
Stars
0
Active Installs
68
Versions
Install in OpenClaw
/install simmer
Description
The prediction market interface for AI agents. Trade Polymarket and Kalshi through one API with self-custody wallets, safety rails, and smart context.
Usage Guidance
Install only if you are comfortable giving the skill access to a Simmer API key and trading workflows. Keep real-money trading disabled until you intentionally verify and link a wallet, avoid setting TRADING_VENUE unless you mean to use a real venue, pin or review the SDK version where possible, and do not send troubleshooting reports until you have checked and redacted secrets, wallet/account identifiers, private strategy details, and conversation context.
Capability Assessment
Credentials
The skill requires SIMMER_API_KEY and can support real-money trading, but it discloses practice-mode defaults, human verification, wallet linking, trade caps, stop loss, and venue selection controls.
Install Mechanism
The manifest and setup instructions install the third-party simmer-sdk package without a pinned version; using the SDK is purpose-aligned, but unpinned installation leaves future package contents outside the reviewed artifact.
Instruction Scope
The troubleshooting section says to always report unrecognized errors or stuck flows to Simmer with raw error text or a free-form message, without requiring user review, redaction, or payload limits.
Persistence & Privilege
The manifest declares no cron, autostart, managed automaton, or entrypoint, and the package contains only markdown instructions plus a JSON manifest.
Purpose & Capability
The skill's stated purpose is prediction-market registration, discovery, and trading through Simmer; API key use, market calls, and optional real-money trading are disclosed and directly tied to that purpose.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install simmer - After installation, invoke the skill by name or use
/simmer - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.25.1
Corrected exit guidance: selling is action='sell' plus a share count, not side='no'. Quickstart now prints the market question before trading, since search matches tags as well as the question.
v1.25.0
- Added comprehensive documentation and safety information for trading on Simmer, including default caps, stop-loss, and reasoning requirements.
- Clarified that all trading defaults to the $SIM virtual venue, with explicit instructions for real-money trading and human verification via claim_url.
- Detailed agent registration steps and environment variable setup, including support for both SDK and REST usage.
- Explained dry-run functionality for trade size/price preview and clear warnings about its limitations.
- Provided links to further documentation and setup skills for advanced features like self-custody wallets and MCP integration.
v1.24.11
Correct the MCP server install line: the live server is the npm package (npm install -g simmer-mcp), not the deprecated PyPI stub.
v1.24.10
Wallet-setup pointer repositioned: external self-custody with OWS as optional key store + Polymarket-import path; Elite tier line says dedicated per-agent wallets.
v1.24.9
UTM attribution tags on dashboard links (SIM-3992)
v1.24.8
Fix backtest example: add --entrypoint run.py to match real CLI signature (SIM-3452)
v1.24.6
Teach get_markets(tags/q/sort/venue) discovery in the API surface (flip-safe wording)
v1.24.5
Surface backtesting in the on-ramp: learn-more row + graduation ladder (backtest -> SIM -> real).
v1.24.4
Fix broken get_markets(q=) example -> find_markets(); clarify market-discovery API surface
v1.24.3
- Version bump to 1.24.3.
- SKILL.md content updated (minor edits).
- skill-card.md file removed.
v1.24.2
Consolidate the simmer overview to a single canonical source (SDK skill). Add simmer-mcp-setup reference row. Per-agent OWS activation detail now lives in simmer-wallet-setup.
v1.24.1
- SKILL.md updated to remove "Start here" from the description and clarify introductory language.
- Metadata version bumped to 1.24.1.
- Minor copy and formatting edits; no changes to functionality or API.
- No changes to code, API surface, or documented safety rails.
v1.24.0
Wallet row now points to simmer-wallet-setup skill (OWS recommended path) instead of the docs page
v1.23.2
- Adds explicit guidance to always check result.success after client.trade(), clarifying that trade failures return a TradeResult object and do not raise exceptions.
- Updates the quick start example to include trade failure handling and a code snippet to check result.error.
- Bumps version to 1.23.2 in the metadata.
v1.23.1
v1.23.1 — ASI scanner reframe per engine v2.4.22 calibration. Adds Safety rails (read first) section surfacing bounding mechanisms (paper-default, claim+wallet for real money, $100/$500/50 caps, auto stop-loss, reversibility). Drops named cross-skill links from Where-to-learn-more (replaced with non-named pointers to docs.simmer.markets and clawhub.ai/skills?q=simmer). Quick-start step 3 leads with paper-default and SimmerClient.from_env(). Two factual fixes: reasoning is optional (not required); set_monitor (not set_position_monitor). No API/SDK behavior change.
v1.23.0
Slim flagship to 129 lines (from 426). Tier A scoping per skill catalog reshape: drop wallet/setup duplication (now in simmer-wallet-setup), drop briefing duplication (now in simmer-briefing), trim changelog/example sections. Pre-publish audit applied (TRADING_VENUE declared, orchestration verbs softened to documentation framing). Skill is the entry point — register, trade in $SIM, point at deeper Tier A skills when needed.
v1.22.2
Mirror envVars + primaryEnv into skill.md frontmatter so the registry summary matches the bundle manifest (clawhub.json). v1.22.1 scan flagged metadata inconsistency between the two sources. No functional changes — only metadata alignment.
v1.22.1
Fix displayName: 'Public' → 'Simmer'. Previous versions inherited the folder-basename default because the publish command omitted --name. No content changes.
v1.22.0
Re-scope bundle to skill.md + clawhub.json only (drops accidentally-included design-system, docs, logos, SVGs). Restore v1.20.5 envVars[] schema with WALLET_PRIVATE_KEY required:false. Fixes OpenClaw scanner suspicious verdict caused by bundle pollution + manifest regression in v1.21.0.
v1.21.1
V2 migration: pUSD is the Polymarket V2 collateral (1:1 backed by USDC.e). Updated requirements + venue copy; added cross-link to docs.simmer.markets/v2-migration.
Metadata
Frequently Asked Questions
What is simmer?
The prediction market interface for AI agents. Trade Polymarket and Kalshi through one API with self-custody wallets, safety rails, and smart context. It is an AI Agent Skill for Claude Code / OpenClaw, with 10389 downloads so far.
How do I install simmer?
Run "/install simmer" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is simmer free?
Yes, simmer is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does simmer support?
simmer is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created simmer?
It is built and maintained by Simmer.Markets (@simmer); the current version is v1.25.1.
More Skills