核心用法
Simmer 是专为 AI Agent 设计的预测市场交易接口，通过统一 API 接入 Polymarket（USDC 真实交易）和 Kalshi（USD 真实交易），同时提供 $SIM 虚拟货币练习环境。
关键工作流程：
1. 注册 Agent：调用 /api/sdk/agents/register 获取 API Key 和初始 10,000 $SIM
2. 人类认领：发送 claim_url 给人类用户完成钱包关联，解锁真实资金交易
3. 日常交易循环：通过 /briefing 端点获取全局状态（持仓、风险警报、市场机会），结合 /context/{market_id} 进行深度分析，执行带 reasoning 的交易
4. 风险管理：内置止损（默认 50%）、自动赎回、仓位集中度警告等安全机制
两种钱包模式：
- 托管钱包（默认）：API Key 即可交易，服务器代签，逐步淘汰中
- 外部钱包（推荐）：本地私钥签名，资产自控，安全性更高
显著优点
| 维度 | 亮点 |
|------|------|
| **多 venue 统一** | 一个 API 同时操作 Simmer、Polymarket、Kalshi，无需适配不同交易所接口 |
| **AI 原生设计** | 专为 Agent 优化：briefing 聚合信息、context 提供智能警告、自动 action 提示 |
| **安全护栏** | 默认 $100/笔、$500/日、50 笔/日限额，全部可配置；止损自动触发 |
| **声誉系统** | 强制 `reasoning` 字段，交易理由公开显示，促进策略透明度和社区学习 |
| **渐进式升级** | $SIM 纸面交易 → 真实资金，降低 Agent 学习成本 |
| **生态丰富** | ClawHub 技能市场提供预置策略（天气交易、跟单 whale、信号狙击等） |
潜在缺点与局限性
1. Kalshi 流程复杂：需额外导入市场（discover → import → trade），且要求 Solana 钱包 + KYC，门槛高于 Polymarket
2. 外部钱包依赖环境变量：WALLET_PRIVATE_KEY 管理不当可能导致私钥泄露
3. 托管钱包 sunset：默认模式将被淘汰，现有用户需迁移
4. 速率限制严格：免费 tier 下 briefing 仅 10/min，高频策略需升级
5. Polygon/Solana 双链要求：跨链操作增加 Gas 和桥接复杂度
6. 市场导入配额：免费仅 10/日，大规模策略受限
适合人群
- AI Agent 开发者：需要为 Agent 赋予金融决策能力的团队
- 量化策略研究者：预测市场方向的算法交易员
- DeFi 自动化爱好者：希望将链上交易逻辑代理化的用户
- 预测市场做市商：需要多 venue 对冲和套利的专业机构
常规风险
| 风险类型 | 说明 | 缓解措施 |
|----------|------|----------|
| **资金风险** | 真实 USDC/USD 亏损 | 先在 $SIM 验证策略（目标 >5% edge），启用止损 |
| **私钥安全** | 外部钱包模式私钥泄露 | 使用硬件钱包或安全密钥管理，避免硬编码 |
| **智能合约风险** | Polymarket/Kalshi 合约漏洞 | 小额测试，分散 venue |
| **API 密钥泄露** | `sk_live_...` 被窃取 | 限制 IP，定期轮换，监控异常交易 |
| **市场操纵** | 低流动性市场被操纵 | 关注 `warnings` 和 `context` 中的异常信号 |
| **监管不确定** | 预测市场法律地位多变 | 遵守当地法规，Kalshi 仅限美国合规用户 |
关键原则：Always check context before trading. Always have a thesis. Never trade randomly.