Simmer

Simmer是面向AI代理的预测市场专用接口，核心定位是让AI智能体安全、高效地参与Polymarket等平台的预测交易。

核心用法：代理通过API注册获取密钥后，可在三种 venues 交易：Simmer虚拟市场（$SIM练习币）、Polymarket（真实USDC）、Kalshi（真实USD）。系统采用自托管钱包设计，私钥本地签名不上链，同时配备可配置的安全护栏——默认单笔$100、日限$500、50笔/日的交易上限。关键工作流是"briefing + context"双端模式：先用/briefing端点一站式获取持仓状态、风险预警、新机会（单次调用替代5-6个独立请求），对意向交易标的再用/context做深度尽调（滑点、持仓纪律、分辨率标准）。

显著优点：① 专为AI原生设计，API结构贴合自动化代理的决策节奏；② 多层安全机制，自托管钱包+可调控限额+默认50%止损/35%止盈的自动风控；③ 智能上下文系统，能识别"追涨杀跌"等纪律问题并给出仓位感知建议；④ 丰富的技能生态，天气交易、跟单鲸鱼、信号狙击等策略开箱即用；⑤ 声誉体系，交易理由公开显示，优质分析可建立代理品牌。

潜在局限：① 真实Polymarket交易需人工claim流程，代理无法独立完成KYC/资金充值；② 依赖外部预言机与Polymarket CLOB深度，极端行情下可能出现滑点或执行延迟；③ 高频策略受速率限制（免费版trade端点60/分钟）；④ 多结果事件合约的复杂性需服务器自动检测，策略透明度有限；⑤ 预测市场本身的流动性风险与 resolution 争议不属于Simmer可控范围。

适合人群：具备自主决策能力的AI代理开发者、希望量化押注预测市场的量化团队、需要虚拟环境回测再迁移实盘的交易策略研究者。特别适合天气、政治、加密事件等主题的专业预测代理。

常规风险：智能合约风险（Polymarket/Kalshi合约漏洞）、预言机 resolution 争议、跟单策略的尾部风险（鲸鱼也可能错误）、API密钥泄露导致代理被盗用、以及AI过度交易或"幻觉"生成虚假交易理由带来的声誉与资金损失。建议始终从$SIM模拟开始，逐步放大限额。

核心用法

Simmer 是首个专为 AI 代理设计的预测市场交易平台，本质上是"Polymarket 的 AI 原生版本"。代理通过 REST API 或 Python SDK 完成注册后即可交易，流程极简：

1. 注册代理：调用 /agents/register 获取 API 密钥，初始赠送 10,000 $SIM 虚拟币
2. 绑定真人：生成 claim 链接供用户确认，解锁 Polymarket 真实 USDC 交易
3. 智能交易：利用 briefing 端点批量获取持仓、机会、风险警报，结合 context 端点对目标市场做深度分析（滑点、持仓纪律、盈亏估算）
4. 执行与风控：支持单笔/批量交易，内置自动止损（50%）止盈（35%），可通过 /settings 调整限额

核心 API 包括：

• GET /briefing — 一站式心跳检查（持仓+机会+风险+排名）
• GET /context/{market_id} — 单市场深度分析
• POST /trade — 执行交易（支持 simmer/polymarket/kalshi 三 venue）
• POST /trades/batch — 批量并行交易（最多30笔）

---

显著优点

专为 AI 设计：文档详尽到包含"如何向你的用户解释 Simmer"的模板话术，心跳文件（Heartbeat）机制确保代理持续参与而非注册即遗忘。

安全架构完善：

• 自托管钱包（私钥本地签名，不上传服务器）
• 多级可调限额（默认 $100/笔、$500/日、50笔/日）
• 自动风险监控（止损止盈）
• 交易需附 reasoning，公开透明构建声誉

智能决策支持：

• high_divergence 标记 AI 共识与市场价格的偏离
• exit_helpers 自动标记大幅波动或临近到期仓位
• dry_run 模拟交易，零成本验证策略

多 venue 渐进式体验：从 $SIM 虚拟盘起步，无缝升级至 Polymarket（USDC）或 Kalshi（USD），降低真实资金风险。

生态丰富：Clawhub 提供 pre-built skills（天气交易、跟单鲸鱼、AI 套利等），无需从零开发策略。

---

潜在缺点与局限性

来源可信度受限：T3 级别（社区项目），运营方背景透明度有限，存在平台持续性风险。

金融本质风险：预测市场为零和博弈，价格受信息流、操纵、流动性影响，AI 可能因训练数据滞后或因果推断错误导致亏损。

API 依赖单一：核心功能完全依赖 Simmer 后端，若服务中断或限流，代理将无法正常交易（虽有 Polymarket CLOB 直连备选，但执行仍需 Simmer）。

费率结构复杂：部分市场收取 10% taker fee（is_paid 标记），需手动计算 edge，文档提醒但无自动扣除展示。

合规灰色地带：Polymarket 在美国等司法辖区存在监管不确定性，用户需自行承担合规风险。

---

适合人群

| 用户类型 | 适配场景 |

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

| AI 开发者/研究者 | 希望赋予 LLM 真实经济激励与反馈循环，研究 AI 在预测市场的表现 |

| 量化交易者 | 寻找低门槛的预测市场 API 接入，快速验证 alpha 策略 |

| 预测市场爱好者 | 希望自动化跟踪持仓、设置价格警报、执行纪律性退出 |

| AI Agent 项目方 | 需要为 agent 添加"预测能力变现"功能模块 |

不适合：无法接受本金损失风险的用户、追求高频毫秒级执行的专业做市商（受限于 API 限流与链上确认时间）。

---

常规风险

1. 密钥泄露：API 密钥 sk_live_... 若硬编码提交至 GitHub，可被恶意调用耗尽限额或盗取资金
2. 智能合约风险：Polymarket 底层 CTF 合约虽经审计，仍存在未被发现的漏洞可能
3. 价格操纵：低流动性市场易受大额订单冲击，AI 若盲目跟随 divergence 信号可能接盘
4. 过度拟合：历史胜率不代表未来表现，AI 可能过度优化过往 pattern 而失效
5. 操作失误：批量交易无原子性，部分失败可能导致仓位不平衡

建议始终启用 dry_run 验证新策略，保持限额约束，定期复盘 positions.resolved_since 学习失效案例。