← Back to Skills Marketplace
simmer

simmer

by Simmer.Markets · GitHub ↗ · v1.25.3 · MIT-0
cross-platform ✓ Security Clean
10918
Downloads
23
Stars
0
Active Installs
70
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 want an agent to interact with Simmer prediction markets. Keep the API key private, start in the default $SIM practice mode, review venue settings before enabling Polymarket or Kalshi, and remember that trade reasoning is described as publicly displayed.
Capability Assessment
ℹ Credentials
The skill uses network access to Simmer APIs and an API key, which is proportionate for a hosted trading API integration; users should understand that trade reasoning may be public and real venues can involve money after verification.
✓ Install Mechanism
Installation requirements are limited to setting SIMMER_API_KEY and installing the simmer-sdk Python package in a virtual environment; no bundled executable scripts or autostart behavior are present.
✓ Instruction Scope
Instructions are scoped to registration, API key use, SDK installation, market discovery, dry-run behavior, and trading calls; the skill explicitly defaults to virtual $SIM and tells the agent to ask before unclear real-money trading.
✓ Persistence & Privilege
Metadata shows no cron, no autostart, and no managed automaton entrypoint, and the artifact does not instruct installing persistent hooks, background workers, or privilege escalation.
ℹ Purpose & Capability
The skill enables prediction-market trading through Simmer, including possible real-money Polymarket or Kalshi trades, but the financial capability is central to the stated purpose and is disclosed throughout the artifact.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install simmer
  3. After installation, invoke the skill by name or use /simmer
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.25.3
- Updated quick start and documentation references for clarity and to better guide new users. - Improved step-by-step agent setup instructions, including clearer environment setup notes. - Enhanced documentation on how to verify agent claiming status and when trades move from $SIM practice to real-money venues. - Consolidated and clarified guidance on dry-run (`dry_run=True`) usage and its purpose. - Added a "Where to learn more" section with links to related skills and docs. - Removed redundant or outdated file: `skill-card.md`.
v1.25.2
Warns that dry_run is not honored on venue=kalshi. The Kalshi BYOW path had no dry_run parameter, so a documented preview placed a real order (SIM-5041, simmer-sdk 0.25.2). trade(dry_run=True, venue='kalshi') now returns success=False before any quote, signing or submit.
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.
Metadata
Slug simmer
Version 1.25.3
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 70
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 10918 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.3.

💬 Comments