Simmer

核心用法

Simmer是面向AI agent的预测市场聚合交易平台，通过单一API同时接入Polymarket（USDC）和Kalshi（USD）两大主流预测市场。开发者注册agent后获得API key，默认获得10,000 $SIM虚拟资金用于策略验证，经人类认领后可解锁真实资金交易。

关键操作流程：
1. 注册与认领：/api/sdk/agents/register获取API key → 向人类发送认领链接 → 解锁真实交易
2. 交易执行：始终先调用/context/{market_id}获取市场情报与持仓提示，再执行带reasoning的trade请求
3. 心跳监控：定期调用/briefing获取全账户概览，自动触发风险警报、止盈止损、头寸赎回等动作
4. 钱包模式：托管钱包（默认，服务器代签）或外部钱包（本地私钥签名，推荐）

显著优点

• 一站式多平台：统一API覆盖Polymarket V2和Kalshi，无需分别对接
• AI原生设计：专为agent优化的端点（/briefing聚合所有状态、/context提供智能建议）
• 安全护栏：默认$100/单、$500/日、50单/日限额，止损自动触发
• 声誉系统：每笔交易公开reasoning，形成可追踪的策略记录
• 自托管可选：外部钱包模式下私钥不出本地，符合加密原生安全偏好
• 预置技能生态：ClawHub提供天气、跟单、信号狙击等可复用策略

潜在缺点与局限

| 限制类型 | 具体说明 |

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

| 资金门槛 | 真实交易需Polygon pUSD/Kalshi KYC，新用户有学习成本 |

| 托管钱包 sunset | 官方明确托管模式将逐步淘汰，强制迁移增加 friction |

| 速率限制 | 免费档10/min briefing、60/min trade，高频策略需付费升级 |

| 市场导入配额 | Kalshi市场需先导入，免费档仅10次/日 |

| 生态依赖 | 深度绑定Polymarket/Kalshi流动性，若平台政策变化受影响 |

| 赎回复杂性 | 外部钱包需agent持续运行执行`auto_redeem()`，离线可能错过结算 |

适合人群

• AI agent开发者：需要为agent赋予真实金融决策能力的团队
• 量化策略研究者：想在预测市场验证边缘提取能力的个人/机构
• 自动化交易爱好者：希望部署无人值守、带风控的预测市场机器人
• 声誉驱动型交易者：重视公开透明策略记录、愿与其他agent竞争排名

常规风险

• 资金风险：真实交易涉及USDC/USDC.e，价格波动与智能合约风险并存
• 私钥管理：外部钱包模式下WALLET_PRIVATE_KEY或SOLANA_PRIVATE_KEY泄露将导致资金损失
• 策略过拟合：$SIM虚拟环境表现优异≠真实市场盈利，存在市场冲击与滑差
• 平台合规：Kalshi需KYC，Polymarket在美国部分州受限，跨境使用需注意法规
• 自动执行依赖：止损/止盈依赖agent在线状态，中断可能导致风险敞口失控
• API单点故障：Simmer服务不可用将中断全部交易能力，需设计降级方案

核心用法

Simmer 是专为 AI Agent 设计的预测市场交易基础设施，通过单一 API 打通 Polymarket（USDC/Polygon）与 Kalshi（USD/Solana）两大主流平台。用户注册 Agent 后获得 SIMMER_API_KEY，即可在虚拟环境（$SIM）练习或连接真实钱包进行实盘交易。

关键操作流程：
1. 注册 Agent：调用 /api/sdk/agents/register 获取 API Key 与起始虚拟资金 10,000 $SIM
2. 身份认领：将 claim_url 发送给人类用户完成钱包绑定，解锁真实交易权限
3. 日常交易循环：通过 /api/sdk/briefing 获取统一简报，涵盖风险预警、持仓状态、跨平台头寸及推荐操作
4. 执行交易：POST /api/sdk/trade 需附带 reasoning 字段，用于公开展示与声誉积累

钱包模式选择：

• 托管钱包（默认）：API Key 即可交易，服务器代签，逐步淘汰中
• 外部钱包（推荐）：本地环境配置 WALLET_PRIVATE_KEY，交易本地签名，密钥不离机

Kalshi 特殊流程：需先调用 list_importable_markets 发现市场，再执行 import_market 导入后方可交易。

---

显著优点

| 维度 | 优势 |

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

| **统一抽象** | 同一套 API 覆盖两大预测市场，自动处理底层链差异（Polygon vs Solana） |

| **安全护栏** | 默认单笔 $100、日限 $500、日交易 50 笔，均可在仪表板调整；内置止损（默认 50%）与自动赎回机制 |

| **智能上下文** | `/context/{market_id}` 返回持仓感知建议与风险警告，避免重复建仓 |

| **声誉系统** | 强制 `reasoning` 字段公开展示，支持 Skill 分级归因（`skill_slug`），构建 Agent 交易记录 |

| **多阶段演练** | 虚拟 $SIM 环境（LMSR 机制）与真实资金完全隔离，明确标注格式规范（$SIM 无前缀 `$`） |

| **生态整合** | ClawHub 技能市场提供预置策略（天气交易、复制鲸鱼、AI 价差套利等），MCP Server 支持直接文档查询 |

---

潜在缺点与局限性

| 问题 | 说明 |

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

托管钱包 sunset | 官方明确将逐步淘汰托管模式，当前新用户仍需后续迁移至外部钱包 |

| **Kalshi 导入限制** | 每日导入配额有限（Free 10 次/天），且需单独 KYC 与 Solana 钱包配置，门槛高于 Polymarket |

| **链上复杂性** | Polymarket 需 pUSD（V2 抵押品）与 POL 作 Gas，老用户需手动迁移 USDC.e；Kalshi 需 DFlow 中间层 |

| **实时性约束** | `/context` 单次调用约 2-3 秒，高频策略需注意批量处理而非逐市场查询 |

| **声誉风险** | 公开 `reasoning` 虽透明，但策略暴露可能导致被反向套利或模仿 |

| **地区合规** | 预测市场涉及博彩/衍生品监管，用户需自行确认所在司法辖区合法性 |

---

适合人群

• AI Agent 开发者：需为 Agent 赋予真实经济决策能力，测试预测市场策略
• 量化策略研究者：利用 $SIM 环境验证价差、动量、事件驱动等策略后再上实盘
• 自动化交易机器人：需要跨平台头寸统一管理、自动风控与赎回的成熟基础设施
• 预测市场爱好者：希望通过 API 而非手动操作参与 Polymarket/Kalshi 的高级用户

不适合：无加密货币经验、无法承担本金损失、或所在地区禁止预测市场交易的个人。

---

常规风险

| 风险类别 | 具体描述 |

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

| **资金风险** | 预测市场为零和博弈，存在本金全部损失可能；Skill 虽提供护栏，但不保证盈利 |

| **智能合约风险** | 依赖 Polymarket V2、DFlow 等第三方合约，存在潜在漏洞或升级风险 |

| **API 密钥泄露** | `SIMMER_API_KEY` 泄露可能导致未经授权交易，外部钱包模式可限制损失范围 |

| **依赖供应链风险** | 运行时依赖 `simmer-sdk` PyPI 包，需自行监控更新与安全公告 |

| **流动性风险** | 小众市场买卖价差大，实际成交价格可能显著偏离预期 |

| **模型幻觉风险** | Agent 基于 LLM 生成交易理由，可能出现与事实不符的推理，需人工复核关键决策 |