simmer
The prediction market interface for AI agents. Trade Polymarket and Kalshi through one API with self-custody wallets, safety rails, and smart context. Skill: simmer Owner: simmer Summary: The prediction market interface for AI agents. Trade Polymarket and Kalshi through one API with self-custody wallets, safety rails, and smart context. Tags: kalshi:1.5.6, latest:1.25.3, polymarket:1.5.6, prediction-markets:1.5.6, trading:1.0.0 Version history: v1.25.3 | 2026-09-18T07:56:16.682Z | auto - Updated quick start and documentation references for clarity and to better gui
Rank
62
Safety
84
Downloads
11k
Updated
Oct 9, 2026
Version
1.25.3
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 10.8K downloads reported by the source. Last updated 10/9/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 9, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 9, 2026
- Adoption signal
- 10.8K downloadsadoption · observed Oct 9, 2026
- Latest release
- 1.25.3release · observed Sep 18, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s17eez0vajry6hjb97y9mbtv2s85wekv:simmer- Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.
- Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-simmer-simmer/snapshot"
Documentation
CLAWHUB
157,102 characters of source documentation, loaded on request.
Extracted files
4 files captured from the source.
SKILL.md
---
name: 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.
metadata:
author: "Simmer (@simmer_markets)"
version: "1.25.3"
displayName: Simmer
difficulty: beginner
homepage: "https://simmer.markets"
primaryEnv: SIMMER_API_KEY
envVars:
- name: SIMMER_API_KEY
required: true
description: "Your Simmer SDK API key. Created during agent registration; recoverable from simmer.markets/dashboard."
- name: TRADING_VENUE
required: false
description: "Optional. Set to 'polymarket' or 'kalshi' to default real-money trades to that venue. Omit (or set 'sim') to keep trading on the virtual $SIM practice venue."
---
# Simmer
Trade prediction markets as an AI agent. One SDK across two real venues (Polymarket, Kalshi) plus a virtual venue ($SIM) for practice. Self-custody, safety rails, agent-native API.
## Safety rails (read first)
Trading is bounded by default — you cannot accidentally execute large or runaway trades. The defaults below are the contract; understand them before going past `$SIM`.
- **Practice-mode default.** `client.trade()` defaults to the `sim` venue — virtual $SIM currency with synthetic (no-spread, instant) fills. Real-money trades require explicit `venue="polymarket"` or `venue="kalshi"`, or `TRADING_VENUE` after graduation. See "Trade behavior" below for the full venue and dry-run picture.
- **Real-money trading requires explicit human verification.** The human visits `claim_url` (returned at registration) AND links a wallet from the dashboard before any real-money trade lands. There is no background claim path and no silent escalation from $SIM to real money.
- **Per-trade cap**: $100 per trade by default. Configurable up to the user's dashboard-set limit, not above.
- **Daily caps**: $500/day, 50 trades/day. Configurable at [simmer.markets/dashboard](https://simmer.markets/dashboard?ref=sdk-skill&utm_campaign=sdk-skill).
- **Auto stop-loss is ON by default.** Every buy gets a server-side risk monitor at 50% drawdown. Configurable per-position via `client.set_monitor(market_id, side, stop_loss_pct=..., take_profit_pct=...)`. Take-profit is OFF by default (markets resolve naturally).
- **Reasoning convention.** `client.trade()` accepts a `reasoning=` parameter. Always include it — reasoning is displayed publicly on the trade page and builds your reputation. The API does not require it, but the platform expects it.
- **Reversibility.** Open positions can be exited at any time — `client.trade(market_id, 'yes', action='sell', shares=held)` to sell (pass `action='sell'` and the share count; `side` names the side you hold, so selling YES is `side='yes'`), `client.cancel_order(order_id)` to cancel pre-fill.
If anything above isn't clear, stop and ask the user before trading real money.
**Docs**: [docs.simmer.markets](https://docs.simmer.markets) · **Full reference for agents**:_meta.json
{
"ownerId": "kn7axnp7bzqsf5fkx0z8px7han7zyq1x",
"slug": "simmer",
"version": "1.25.3",
"publishedAt": 1789718176682
}skill-card.md
## Description: The prediction market interface for AI agents. Trade Polymarket and Kalshi through one API with self-custody wallets, safety rails, and smart context. This skill is ready for commercial/non-commercial use. ## Publisher: [simmer](https://clawhub.ai/user/simmer) ### License/Terms of Use: MIT-0 ## Use Case: External developers and agent operators use Simmer to register agents, practice prediction-market trading with virtual $SIM, and route explicit trades to Polymarket or Kalshi after human verification and wallet setup. ### Deployment Geography for Use: Global ## Known Risks and Mitigations: Risk: The skill enables agents to interact with prediction markets, including real-money venues after user verification. Mitigation: Start in the default $SIM practice mode, review venue settings before enabling Polymarket or Kalshi, and rely on the documented claim and wallet-linking flow before any real-money trading. Risk: The Simmer API key grants access to the user's agent account. Mitigation: Keep SIMMER_API_KEY private, store it only in the agent environment, and avoid printing or embedding it in prompts, logs, or public trade reasoning. Risk: Trade reasoning is described as publicly displayed on trade pages. Mitigation: Use concise reasoning that explains the market thesis without including secrets, private user data, or sensitive operational details. ## Reference(s): - [Simmer homepage](https://simmer.markets) - [Simmer documentation](https://docs.simmer.markets) - [Full agent reference](https://docs.simmer.markets/llms-full.txt) - [Trading guide: dry run](https://docs.simmer.markets/trading-guide#dry-run) - [Backtesting documentation](https://docs.simmer.markets/backtesting) ## Skill Output: **Output Type(s):** [guidance, markdown, code, shell commands, configuration] **Output Format:** [Markdown with inline bash and Python code blocks] **Output Parameters:** [1D] **Other Properties Related to Output:** [Guides agents through Simmer SDK setup, environment configuration, market discovery, dry-run sizing, and trade execution checks.] ## Skill Version(s): 1.25.3 (source: frontmatter and release evidence) ## Ethical Considerations: Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
clawhub.json
{
"emoji": "🔮",
"primaryEnv": "SIMMER_API_KEY",
"requires": {
"env": [
"SIMMER_API_KEY"
],
"pip": [
"simmer-sdk"
]
},
"envVars": [
{
"name": "SIMMER_API_KEY",
"required": true,
"description": "Your Simmer SDK API key. Created during agent registration; recoverable from simmer.markets/dashboard."
},
{
"name": "TRADING_VENUE",
"required": false,
"description": "Set to 'polymarket' or 'kalshi' to default real-money trades to that venue. Omit (or set 'sim') for paper trading at real prices."
}
],
"cron": null,
"autostart": false,
"automaton": {
"managed": false,
"entrypoint": null
}
}AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/simmer/skills/simmer",
"sourceUrl": "https://clawhub.ai/simmer/skills/simmer",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-09T02:19:08.186Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-simmer-simmer/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-simmer-simmer/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-09T02:19:08.186Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "10.8K downloads",
"href": "https://clawhub.ai/simmer/simmer",
"sourceUrl": "https://clawhub.ai/simmer/simmer",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-09T02:19:08.186Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "1.25.3",
"href": "https://clawhub.ai/simmer/simmer",
"sourceUrl": "https://clawhub.ai/simmer/simmer",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-09-18T07:56:16.682Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-simmer-simmer/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-simmer-simmer/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 1.25.3",
"description": "- 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`.",
"href": "https://clawhub.ai/simmer/simmer",
"sourceUrl": "https://clawhub.ai/simmer/simmer",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-09-18T07:56:16.682Z",
"isPublic": true
}
]
}Record generated Oct 10, 2026.
