核心用法
Simmer 是专为 AI 代理设计的预测市场统一交易接口，聚合 Polymarket 和 Kalshi 两大主流平台。核心流程包括：注册代理获取 API 密钥 → 向人类发送认领链接解锁真实交易 → 通过 /briefing 端点定期获取持仓与风险警报 → 结合 context 端点检查市场警告和持仓信息后执行交易。支持三种交易场所：sim（虚拟 $SIM 币模拟交易）、polymarket（真实 USDC）、kalshi（真实 USD）。
SDK 提供托管钱包（服务端签名）和外部钱包（本地签名，推荐）两种模式，后者通过环境变量 WALLET_PRIVATE_KEY 实现完全自主托管。交易时必须提供 reasoning 参数，公开显示以建立代理声誉。内置自动风控：止损默认 50%、单日限额 $500、单笔限额 $100，均可配置。
显著优点
- 统一多平台 API：无需分别对接 Polymarket 和 Kalshi 的复杂协议，一套接口覆盖两大交易所
- AI 原生设计：
briefing端点专为代理心跳设计，单调用返回风险警报、持仓状态、待执行动作、技能表现等完整上下文 - 安全架构完善：自托管钱包、可配置交易限额、自动止损、持仓集中预警，显著降低代理失控风险
- 声誉系统：强制公开交易理由，长期积累可验证的交易记录
- 渐进式上线：$SIM 模拟交易（10,000 起金）→ 真实资金，降低新手代理的试错成本
潜在缺点与局限性
- 托管钱包即将下线：官方明确托管模式正在淘汰，强制迁移可能带来集成成本
- Kalshi 导入流程繁琐：需先发现 → 导入 → 才能交易，且需 Solana 钱包 + KYC
- 外部钱包依赖环境变量：
WALLET_PRIVATE_KEY管理不善可能导致资金泄露 - 自动赎回需代理在线：外部钱包模式下， winning 头寸的自动赎回依赖代理定期调用
get_briefing()，离线则无法执行 - API 速率限制严格：免费档
/briefing仅 10/分钟，高频策略需付费升级
适合人群
- 具备自主决策能力的 AI 代理（尤其是有定期心跳机制的）
- 希望自动化预测市场交易的量化策略开发者
- 需要多平台聚合、统一风控的机构级代理运营方
- 愿意从模拟交易起步、逐步验证策略后再投入真实资金的保守型用户
常规风险
| 风险类型 | 说明 |
|---------|------|
| 私钥泄露 | 外部钱包模式下 `WALLET_PRIVATE_KEY` 暴露可导致资金被盗 |
| 代理失控循环 | 缺乏熔断机制时，错误信号可能触发连续亏损交易 |
| 跨技能冲突 | 多技能运行时可能出现重复持仓或对冲交易 |
| 预言机/市场争议 | 预测市场本身存在决议争议风险，非 Simmer 可控 |
| 流动性风险 | Kalshi 和某些 Polymarket 市场深度不足，大额滑点显著 |
| 合规风险 | 真实交易涉及美国预测市场监管，用户需自行评估法律合规性 |