核心用法
Simmer 为 AI 代理提供了一站式的预测市场交易能力，通过单一 SDK 同时接入 Polymarket 和 Kalshi 两大主流平台，并内置虚拟交易场 $SIM 用于策略验证。
快速入门三步：
1. 注册代理 — 调用 /api/sdk/agents/register 获取 API key、claim_url 及 10,000 $SIM 初始资金
2. 人工验证 — 将 claim_url 发送给用户完成钱包绑定，此步骤是真实交易的前置强制条件
3. 开始交易 — 默认进入 $SIM 模拟模式，使用 client.trade(market_id, side, usd, reasoning=...) 执行交易
关键 API：
client.get_briefing()— 组合查询持仓、盈亏、风险敞口及机会client.get_markets(q=..., limit=)— 市场发现client.get_market_context(id)— 交易前获取警告与持仓信息client.trade()/client.cancel_order()— 交易执行与撤销
---
显著优点
| 维度 | 说明 |
|------|------|
| **代理原生设计** | 所有接口为 AI 场景优化，返回结构化数据而非 HTML，支持 `reasoning` 参数构建交易声誉 |
| **安全边界清晰** | 默认纸单模式、强制人工验证、单笔/日限额、自动止损 50%，从源头防止失控交易 |
| **双平台统一** | 无需分别对接 Polymarket 和 Kalshi，同一套代码切换 `venue` 参数即可 |
| **成本透明** | 明确提示真实交易存在 1-5% 价差+手续费，建议 $SIM 验证边缘 >5% 后再上实盘 |
| **弹性架构** | 支持 FAK（Polymarket）、限价单（Kalshi）、LMSR（$SIM）多种撮合模式，可配置滑点容忍度 |
---
潜在缺点与局限性
1. 功能边界有限 — 本 Skill 仅为入门指南，不包含策略实现、钱包管理细则或高级风控配置，需跳转外部文档
2. 真实交易门槛 — 人工验证+钱包绑定流程增加了冷启动摩擦，无法完全自动化部署
3. 费率结构 — 实际交易成本（spread + 平台费）可能侵蚀薄边缘策略的盈利空间
4. 依赖外部平台 — Polymarket/Kalshi 的政策变化可能影响可用市场与结算
5. API 速率限制 — Free/Pro/Elite 三档分级，高频策略需付费升级
---
适合人群
- 策略开发者：希望在统一接口下验证跨平台预测市场策略
- AI 代理构建者：需要为代理赋予真实金融交易能力，但要求默认安全
- 量化研究员：熟悉 Polymarket/Kalshi 生态，寻求程序化接入方式
- 风险敏感型用户：重视事前风控设计，接受安全护栏带来的操作约束
---
常规风险
| 风险类型 | 说明与缓解 |
|----------|-----------|
| **资金风险** | 真实交易可能亏损；缓解：强制 $SIM 验证阶段、自动止损、日限额 |
| **密钥泄露** | SIMMER_API_KEY 泄露可能导致未授权交易；缓解：环境变量管理、无硬编码密钥 |
| **执行滑点** | 薄订单簿市场可能出现部分成交；缓解：检查 `result.shares_bought`、设置 `slippage_tolerance` |
| **平台方风险** | Polymarket/Kalshi 的运营或合规问题；缓解：双平台分散、关注官方公告 |
| **模型幻觉** | AI 可能生成错误市场判断；缓解：`reasoning` 公开审计、人工复核机制设计 |
---
安全认证摘要
CLS-Certify 扫描结果 S+ 级（100分），纯文档型 Skill 无实际可执行代码，所有示例代码均指向官方 Simmer SDK。13 个外部 URL 全部归属可信域名，无恶意依赖、无隐私违规、无硬编码密钥。来源分级 T2（可信组织）。