Simmer

核心用法

Simmer 是专为 AI 代理设计的预测市场聚合交易接口，通过单一 API 同时接入 Polymarket（USDC）和 Kalshi（USD）两大平台。核心工作流分为四步：注册代理获取 API Key → 邀请人类认领启用实盘 → 定期拉取 /briefing 获取风险警报与待办事项 → 带理由执行交易。

关键设计包括：

• 双钱包模式：托管模式（服务器代签）与外部钱包模式（本地私钥签名，推荐）
• 安全限幅：默认单笔$100/日累计$500/日交易上限，可配置止损（默认50%）
• 智能上下文：GET /context/{market_id} 返回持仓状态、市场警告、价格偏离等决策辅助
• 统一简报：GET /briefing 单端点聚合多 venues（Sim 虚拟盘/Polymarket/Kalshi）的持仓、PnL、风险警报与技能表现

典型调用模式：先 briefing 扫描 → 按 risk_alerts 优先级处理 → 遍历 venues.*.actions 执行待办 → 检查 by_skill 表现调整策略 → 扫描 opportunities.new_markets 发现机会。

显著优点

1. 代理原生设计：API 文档提供 llms-full.txt 专为 LLM 上下文优化，错误返回带 fix 字段，支持 /troubleshoot 自动诊断
2. 统一抽象层：同一套 SDK/REST 接口操作多交易所，自动处理不同链的签名、gas、赎回（Polymarket 自动 redeem）
3. 风险内建：默认限幅、止损、rebuy 保护、集中度警告，降低代理自主交易的资金风险
4. 声誉系统：强制 reasoning 字段公开透明，技能可上架 ClawHub 获得 $SIM 创作者收益
5. 渐进式上手：$SIM 虚拟盘（LMSR）练手 → 实盘 graduated 交易，降低人类信任门槛

潜在缺点与局限

• 托管钱包 sunset：官方推荐转向外部钱包，迁移成本存在
• 链上复杂性：Polymarket 需 Polygon USDC.e + POL gas，Kalshi 需 Solana + KYC，多链运维负担
• 速率限制严格：免费 tier 下单 60/分钟、简报 10/分钟，高频策略需付费升级
• 市场覆盖依赖导入：Kalshi 市场需先 import_market 才能交易，存在 10-100/日 配额限制
• MCP 与 SDK 成熟度：Python SDK 为主要支持，其他语言生态待完善

适合人群

• AI 代理开发者：需要为代理赋予预测市场交易能力的团队
• 量化策略研究员：专注预测市场（政治、天气、加密等）的策略实现
• 自动化交易机器人：需要跨 Polymarket/Kalshi 的聚合执行基础设施
• 谨慎型用户：重视自托管、限额风控、透明 reasoning 的代理运营者

常规风险

| 类别 | 说明 |

|------|------|

| 资金风险 | 真实 venues 涉及 USDC/USD 本金损失；默认限幅可缓解但非完全防护 |

| 私钥安全 | 外部钱包模式依赖本地 `WALLET_PRIVATE_KEY` 环境变量管理 |

| 智能合约/桥接风险 | Polymarket（Polygon）、Kalshi（Solana/DFlow）的底层合约与跨链桥风险 |

| 代理失控 | 自动化循环若未正确设置止损/限幅，可能导致连续亏损 |

| KYC/合规 | Kalshi 实名 KYC 要求，部分司法管辖区限制预测市场参与 |

| API 可用性 | 依赖 Simmer 服务端，rate limit 或故障影响代理运行 |

| 预言机/结算风险 | 预测市场结果判定依赖人工或中心化预言机，存在争议可能 |

建议：生产环境启用外部钱包 + 严格限幅 + 强制人类审批大额交易，定期审查 by_skill PnL 表现及时止损策略。

核心用法

Simmer是一个面向AI代理的预测市场统一交易接口，让AI能够在Polymarket和Kalshi两大平台上自动化交易预测事件。核心流程包括：注册代理获取API密钥（起步10,000 $SIM虚拟资金）→ 发送认领链接给人类用户解锁真实资金 → 通过/briefing端点获取综合交易简报 → 研究市场并调用trade()执行交易。支持三种交易场所：sim（虚拟$SIM）、polymarket（真实USDC）、kalshi（真实USD）。

关键设计亮点包括智能简报系统——单次API调用即可获取跨平台持仓、风险警报、待执行动作和技能表现，避免频繁轮询；安全护栏机制——默认每笔$100、每日$500、每日50笔交易上限，全部可配置；以及自托管钱包模式——私钥本地签名，服务器永不接触用户资金。

显著优点

1. 统一多平台接入：单一API打通Polymarket（加密事件）和Kalshi（传统预测），降低多平台集成成本。

2. AI原生设计：内置reasoning字段强制代理阐述交易逻辑，建立可审计的声誉系统；context端点提供持仓感知的市场分析和风险警告。

3. 渐进式风险控制：虚拟资金起步 → 真实资金 graduated access，配合自动止损（默认50%）、再买入保护、自动赎回获胜仓位等机制。

4. 技能生态系统：支持ClawHub技能市场，可安装预置策略（天气交易、鲸鱼跟单、AI价差套利等），并通过by_skill维度追踪各策略盈亏。

5. 开发者体验优秀：提供Python SDK、MCP服务器、llms-full.txt一站式文档、详细错误修复提示，以及无需私钥即可启动的托管钱包模式。

潜在缺点与局限性

1. 托管钱包 sunset 中：官方文档明确托管钱包"正被淘汰"，推荐外部钱包模式，但后者要求用户自行管理Polygon/Solana私钥和gas费，提高了入门门槛。

2. Kalshi 导入摩擦：Kalshi市场需先调用import_market才能交易，且需Solana钱包+KYC，流程较Polymarket复杂。

3. 费率与限额约束：免费 tier 的 briefing 限10次/分钟，市场导入限10次/日，高频策略需付费升级（Pro/Elite）。

4. 依赖外部链上状态：Polymarket交易依赖Polygon网络确认，gas价格波动和链上拥堵可能影响执行时效。

5. 预测市场固有风险：二元结果事件存在归零风险，AI代理可能因训练数据时效性或黑天鹅事件产生系统性误判。

适合人群

• AI代理开发者：需要为代理赋予预测市场交易能力的团队
• 量化策略研究者：希望测试事件驱动策略（政治、天气、加密、体育）的开发者
• DAO/社区治理工具：需要链上化社区预测和决策机制的项目方
• 对DeFi有一定认知的用户：理解自托管钱包、跨链桥接、gas费机制的投资者

常规风险

1. 资金风险：真实 venues 涉及USDC/USDC.e资金损失可能，建议虚拟资金验证策略后再迁移
2. 智能合约风险：Polymarket、Kalshi、DFlow合约虽经审计但非绝对安全
3. API密钥泄露：SIMMER_API_KEY或WALLET_PRIVATE_KEY泄露可导致未授权交易
4. 模型幻觉风险：AI代理可能基于过时训练数据或错误推理进行交易，强制reasoning字段仅为事后审计，不阻止错误决策
5. 监管不确定性：预测市场监管因司法管辖区而异，用户需自行评估合规义务