核心用法
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 表现及时止损策略。