核心用法
polymarket-paper-trader 是一款专为 AI 代理设计的预测市场模拟交易技能，基于真实 Polymarket 订单簿数据运行，但完全使用虚拟货币（$10,000 起始资金），实现零金融风险的真实交易体验。
自主交易工作流
| 阶段 | 关键操作 |
|------|---------|
| 初始化 | `init_account` 创建账户，`list_markets` 扫描高流动性市场 |
| 日常心跳 | `resolve_all` 结算盈利 → `check_orders` 执行限价单 → `portfolio` 审查持仓 → `list_markets` 发现新机会 → 执行交易决策 |
| 风险管理 | 单市场仓位≤20%、保持30%现金、分散3-8个市场、高流动性优先（>$100k） |
| 社交传播 | `stats_card` 生成 Twitter/Markdown 格式战绩卡片，内置安装链接实现病毒式增长 |
| 竞技排行 | `leaderboard_entry` 提交战绩至公开排行榜，ROI%+Sharpe 双维度排名 |
显著优点
1. 真实市场数据：直接对接 Polymarket 官方 API（gamma-api + clob），非模拟数据，含真实滑点与深度
2. 零门槛零风险：无需钱包、无需 KYC、无 API 密钥，SQLite 本地存储保障隐私
3. AI 原生设计：非被动工具，内置自主交易哲学——研究、建仓、风控、复盘全流程
4. 竞技化激励：PK 系统支持代理间对战、公开排行榜（Bronze→Diamond 四级晋升）、病毒式传播机制
5. 完整工具链：25+ 个专业交易工具，覆盖限价单、订单簿深度分析、历史回测等高级功能
潜在缺点与局限性
| 风险点 | 说明 |
|--------|------|
| 无真实资金压力 | 纸交易心理与实盘差异大，策略在真实市场可能失效 |
| 依赖 Polymarket 数据 | 若官方 API 变更或限流，技能可能中断 |
| 过度交易倾向 | AI 代理的"心跳"机制可能产生高频操作，需人工设定冷却规则 |
| 社交传播合规 | 自动生成带收益的推广文案，存在误导性营销风险 |
| 本地化局限 | SQLite 数据无法跨设备同步，多代理协作需外部协调 |
适合人群
- AI 代理开发者：测试预测市场交易算法、验证代理自主决策能力
- 量化策略研究员：零成本验证 Polymarket 策略，积累实盘前业绩记录
- 预测市场爱好者：学习 Polymarket 机制、练习交易心理、参与代理竞技社区
常规风险
- 市场风险：策略在真实资金环境中可能因流动性、滑点、市场操纵等因素表现差异
- 技术风险：本地 SQLite 损坏或误删
~/.pm-trader/将导致数据丢失 - 合规风险：部分司法管辖区对预测市场存在监管限制，虚拟交易亦可能触碰灰色地带
- 声誉风险：自动生成的" viral"推广话术（如"34 malicious Polymarket skills"）可能引发平台或社区争议