@catalyst-team/poly-mcp 0.1.1 → 0.1.2

package/docs/e2e-02/README.md

@@ -0,0 +1,102 @@
+# Poly-MCP E2E 能力评估 v2
+
+> 2024-12-29 (更新)
+
+---
+
+## 概述
+
+本目录包含 poly-mcp 与 poly-sdk 的能力差距分析，识别缺失的工具和参数，并提供实现计划。
+
+## 文档索引
+
+| 文档 | 内容 |
+|------|------|
+| [00-gap-analysis.md](./00-gap-analysis.md) | 完整能力差距分析 |
+| [01-test-scenarios.md](./01-test-scenarios.md) | 29 个真实场景测试 |
+| [02-implementation-plan.md](./02-implementation-plan.md) | 分阶段实现计划 |
+
+---
+
+## 实现状态 ✅
+
+### 场景覆盖率
+
+```
+总场景数: 29
+✅ 完整支持: 26 (90%)
+⚠️ 部分支持: 1 (3%)
+❌ 无法完成: 2 (7%)
+```
+
+### 新增工具 (18 个)
+
+| 类别 | 工具 | 状态 |
+|------|------|------|
+| **MarketService** | `get_klines` | ✅ 已实现 |
+| | `get_price_history` | ✅ 已实现 |
+| | `detect_arbitrage` | ✅ 已实现 |
+| | `detect_market_signals` | ✅ 已实现 |
+| | `get_realtime_spread` | ✅ 已实现 |
+| **TradingService** | `cancel_all_orders` | ✅ 已实现 |
+| | `get_my_trades` | ✅ 已实现 |
+| | `get_earnings` | ✅ 已实现 |
+| | `get_current_rewards` | ✅ 已实现 |
+| | `check_order_scoring` | ✅ 已实现 |
+| **OnchainService** | `ctf_split` | ✅ 已实现 |
+| | `ctf_merge` | ✅ 已实现 |
+| | `ctf_redeem` | ✅ 已实现 |
+| | `get_position_balance` | ✅ 已实现 |
+| | `get_market_resolution` | ✅ 已实现 |
+| | `check_ctf_ready` | ✅ 已实现 |
+| | `estimate_gas` | ✅ 已实现 |
+| | `get_gas_price` | ✅ 已实现 |
+
+---
+
+## 剩余差距
+
+### 暂不实现 (SmartMoneyService)
+
+| 服务/工具 | 原因 |
+|-----------|------|
+| `get_smart_money_list` | SmartMoneyService 是 WalletService 封装，优先级低 |
+| `check_is_smart_money` | 同上 |
+
+**变通方案**:
+- 使用 `get_leaderboard(sortBy="pnl")` 获取高 PnL 钱包
+- 使用 `get_trader_profile` 查看 `smartScore`
+
+---
+
+## 文件变更
+
+### 新增文件
+
+```
+packages/poly-mcp/src/tools/onchain.ts    # CTF 操作工具
+```
+
+### 修改文件
+
+```
+packages/poly-mcp/src/tools/market.ts     # 添加 5 个工具
+packages/poly-mcp/src/tools/trade.ts      # 添加 5 个工具
+packages/poly-mcp/src/tools/index.ts      # 更新导出
+packages/poly-mcp/src/index.ts            # 注册新工具
+packages/poly-mcp/src/types.ts            # 添加类型定义
+```
+
+---
+
+## 工具总数
+
+| 类别 | 数量 |
+|------|------|
+| Trader | 7 |
+| Market | 10 |
+| Order | 4 |
+| Trade | 7 |
+| Wallet | 12 |
+| Onchain (CTF) | 8 |
+| **总计** | **48** |

package/docs/reports/simonbanza-strategy-analysis-2025-12-25.md

@@ -0,0 +1,420 @@
+# simonbanza 交易策略深度分析
+
+> 地址: `0x5350afcd8bd8ceffdf4da32420d6d31be0822fda`
+> 分析日期: 2025-12-25
+> 数据来源: Polymarket API
+
+---
+
+## 1. Executive Summary
+
+**simonbanza** 是 Polymarket 排行榜 **#1** 的交易者，累计盈利 **$171,154**。
+
+### 核心发现
+
+| 发现 | 描述 |
+|------|------|
+| **零卖出策略** | 从不主动卖出，100% 持有到市场结算 |
+| **押注冷门** | 专门买入低概率结果 (10-20% odds) |
+| **分批建仓** | 通过数十笔小单以固定限价累积仓位 |
+| **高集中度** | 单市场最大投入 $8,500+，不分散 |
+| **体育专精** | 当前 99%+ 仓位在 NFL 比赛 |
+
+### 收益来源推测
+
+由于该交易者**从不卖出**，$171K 的盈利只能来自：
+1. **已结算市场的正确预测** - 买入冷门 → 冷门发生 → 获得 5-10 倍回报
+2. **持续的逆向投资成功** - 在市场错误定价时押注
+
+---
+
+## 2. 交易者档案
+
+### 基本信息
+
+| 指标 | 值 | 说明 |
+|------|-----|------|
+| 用户名 | simonbanza | - |
+| 全球排名 | #1 / 10,000 | 历史最高盈利 |
+| 总 PnL | $171,154.58 | 来自 Leaderboard |
+| Smart Score | 81 | 入场时机优秀 |
+| 胜率 | 66.67% | 2/3 的仓位盈利 |
+| 最后交易 | 2025-12-25 14:38 UTC | 活跃中 |
+
+### 当前持仓状态
+
+| 市场 | 押注方向 | 持仓量 | 成本 | 市场概率 | 浮盈 |
+|------|---------|--------|------|---------|------|
+| Cowboys vs Commanders | Commanders | 42,545 | $8,509 | 20.5% | +$213 (+2.5%) |
+| Broncos vs Chiefs | Chiefs | 30,454 | $3,350 | 11.5% | +$152 (+4.5%) |
+| Erdoğan out 2025? | No | 20 | $19.86 | 99.45% | +$0.03 |
+
+**总持仓价值**: ~$11,879
+**总浮盈**: +$365 (+3.1%)
+
+---
+
+## 3. 今日交易详细分析
+
+### 3.1 交易概览
+
+| 统计项 | 值 |
+|--------|-----|
+| 总交易数 | 100+ 笔 |
+| 交易时间段 | 13:04 - 14:38 UTC (~1.5小时) |
+| 买入总额 | $10,266+ |
+| 卖出总额 | $0 (零卖出) |
+| 交易市场数 | 2 个 (NFL 比赛) |
+
+### 3.2 Cowboys vs Commanders 建仓过程
+
+**市场信息**:
+- 比赛时间: 2025-12-25 08:00 ET
+- Cowboys (主队) 当前赔率: 79.5%
+- Commanders (客队) 当前赔率: 20.5%
+- 总交易量: $942,138
+
+**建仓分析**:
+
+```
+目标: Commanders (冷门)
+入场价格: 固定 $0.20
+总投入: ~$8,509
+获得股数: 42,545 shares
+潜在回报: 如果 Commanders 赢 → 42,545 × $0.80 = $34,036 收益 (400% ROI)
+```
+
+**交易时间线** (按金额排序):
+
+| 时间 (UTC) | 金额 (USDC) | 股数 | 说明 |
+|------------|-------------|------|------|
+| 13:54:47 | $5,070 | 25,350 | 最大单笔，吃掉流动性 |
+| 13:34:33 | $790 | 3,951 | 大单 |
+| 13:59:49 | $540 | 2,700 | 大单 |
+| 13:58:49 | $80 | 400 | 中单 |
+| 13:48:13 | $75 | 375 | 中单 |
+| ... | ... | ... | 剩余 ~50 笔小单 |
+
+**建仓策略特点**:
+1. **先小单探路**: 最初用 $1-10 的小单测试流动性
+2. **大单吃深度**: 确认流动性后，用 $5,000+ 的大单快速建仓
+3. **持续补仓**: 继续用小单捡漏，维持 $0.20 的平均成本
+
+### 3.3 Broncos vs Chiefs 建仓过程
+
+**市场信息**:
+- 比赛时间: 2025-12-25 15:15 ET
+- Broncos 当前赔率: 88.5% (大热门)
+- Chiefs 当前赔率: 11.5% (大冷门)
+- 总交易量: $918,389
+
+**关键洞察**: Chiefs 是 NFL 本赛季最强球队之一，但市场给出仅 11.5% 的胜率！
+
+**建仓分析**:
+
+```
+目标: Chiefs (超级冷门)
+入场价格: 固定 $0.11
+总投入: ~$3,350
+获得股数: 30,454 shares
+潜在回报: 如果 Chiefs 赢 → 30,454 × $0.89 = $27,104 收益 (809% ROI)
+```
+
+**交易时间线** (按金额排序):
+
+| 时间 (UTC) | 金额 (USDC) | 股数 | 说明 |
+|------------|-------------|------|------|
+| 13:57:27 | $2,594 | 23,584 | 最大单笔 |
+| 13:40:43 | $309 | 2,809 | 大单 |
+| 14:17:17 | $165 + $110 | 2,499 | 连续两笔大单 |
+| ... | ... | ... | 剩余 ~30 笔小单 |
+
+**建仓策略特点**:
+1. **更激进的大单**: Chiefs 市场流动性更好，单笔最大 $2,594
+2. **固定限价 $0.11**: 所有交易价格完全一致
+3. **时间分散**: 交易分布在 1 小时内
+
+---
+
+## 4. 交易模式深度分析
+
+### 4.1 零卖出策略 (Hold-to-Settlement)
+
+**观察**: 在 100+ 笔交易记录中，**没有一笔卖出**。
+
+**策略含义**:
+
+```
+传统交易者:        simonbanza:
+买入 → 价格上涨 → 卖出获利     买入 → 持有 → 等待结算
+
+风险: 市场波动                 风险: 只有输赢两种结果
+收益: 有限 (价差)              收益: 巨大 (5-10倍)
+```
+
+**为什么这有效**:
+1. **避免摩擦成本**: 不卖出 = 不支付买卖价差和手续费
+2. **最大化收益**: 如果预测正确，获得完整的赔率回报
+3. **简化决策**: 不需要判断"何时卖出"
+
+### 4.2 逆向投资 (Contrarian Betting)
+
+**观察**: 两个仓位都是**押注冷门**。
+
+| 市场 | 主流观点 | simonbanza 观点 |
+|------|---------|-----------------|
+| Cowboys vs Commanders | Cowboys 赢 (80%) | Commanders 赢 |
+| Broncos vs Chiefs | Broncos 赢 (89%) | Chiefs 赢 |
+
+**逆向投资的数学逻辑**:
+
+```
+假设 simonbanza 认为:
+- Commanders 实际胜率: 30% (市场给 20%)
+- Chiefs 实际胜率: 25% (市场给 11%)
+
+期望值计算:
+Commanders: 0.30 × $4 收益 - 0.70 × $1 成本 = +$0.50/股
+Chiefs: 0.25 × $8 收益 - 0.75 × $1 成本 = +$1.25/股
+
+只要认为市场低估了冷门概率，押注冷门就是正期望值！
+```
+
+### 4.3 分批限价建仓 (Scaled Limit Orders)
+
+**观察**: 用固定价格 ($0.20, $0.11) 通过多笔订单累积仓位。
+
+**执行细节**:
+
+```
+Commanders 建仓:
+├── 先挂限价单 @ $0.20
+├── 小单成交 → 确认价格可行
+├── 大单吃单 → 快速建立核心仓位
+└── 继续小单补仓 → 捡漏其他卖家
+
+Chiefs 建仓:
+├── 限价单 @ $0.11
+├── 相同的分批策略
+└── 更多大单 (流动性更好)
+```
+
+**优势**:
+1. **控制成本**: 不会因为市价单推高价格
+2. **减少冲击**: 分批进入不惊动市场
+3. **捡漏机会**: 持续挂单等待对手卖出
+
+### 4.4 高集中度投资
+
+**观察**: 单市场投入 $8,500+，不追求分散。
+
+```
+仓位分布:
+├── Commanders: $8,509 (71.6%)
+├── Chiefs: $3,350 (28.2%)
+└── Erdoğan: $20 (0.2%) ← 测试仓位
+```
+
+**这意味着**:
+1. **高置信度交易**: 只在非常确信时才重仓
+2. **不稀释收益**: 分散会降低正确时的回报
+3. **接受波动**: 愿意承担单个市场的风险
+
+---
+
+## 5. 历史盈利推测
+
+### 5.1 $171K 从何而来?
+
+由于我们只能看到最近的交易，无法直接查询历史。但根据当前策略推测：
+
+**盈利模式**:
+```
+1. 寻找被低估的冷门结果
+2. 大额押注 (可能 $10,000-50,000 / 市场)
+3. 持有到结算
+4. 冷门发生 → 获得 5-10 倍回报
+```
+
+**假设历史案例**:
+
+| 假设市场 | 投入 | 买入价 | 结果 | 回报 |
+|---------|------|--------|------|------|
+| 体育赛事 A | $20,000 | 0.15 | 冷门发生 | +$113,333 |
+| 体育赛事 B | $10,000 | 0.20 | 冷门发生 | +$40,000 |
+| 体育赛事 C | $15,000 | 0.25 | 冷门发生 | +$45,000 |
+| 其他失败 | -$30,000 | - | 热门发生 | -$30,000 |
+| **累计** | | | | **~$170,000** |
+
+### 5.2 为什么能持续成功?
+
+**可能的优势来源**:
+
+1. **体育专业知识**
+   - 深入了解 NFL 赛事
+   - 能识别市场对某些球队的偏见
+
+2. **市场定价偏差**
+   - 预测市场受"人气"影响
+   - 热门球队被高估，冷门被低估
+
+3. **纪律性执行**
+   - 严格的限价单策略
+   - 不追涨杀跌
+
+4. **资金管理**
+   - 集中但不过度 (单笔 < 总资金 10%?)
+   - 能承受连续失败
+
+---
+
+## 6. 今日仓位风险分析
+
+### 6.1 Cowboys vs Commanders
+
+**投注**: $8,509 押 Commanders 赢
+
+**分析**:
+- Cowboys 本赛季战绩: 7-8 (一般)
+- Commanders 本赛季战绩: 10-5 (季后赛边缘)
+- 市场给 Commanders 20% 胜率可能偏低
+
+**潜在结果**:
+- Commanders 赢: +$34,036 收益
+- Cowboys 赢: -$8,509 损失
+
+### 6.2 Broncos vs Chiefs
+
+**投注**: $3,350 押 Chiefs 赢
+
+**分析**:
+- Chiefs 是卫冕冠军，本赛季 14-1
+- Broncos 本赛季 9-6
+- 市场给 Chiefs 仅 11% 胜率**极其异常**
+
+**可能原因**:
+1. Chiefs 可能轮休主力 (已锁定季后赛)
+2. 客场比赛
+3. 市场错误定价?
+
+**潜在结果**:
+- Chiefs 赢: +$27,104 收益
+- Broncos 赢: -$3,350 损失
+
+### 6.3 总风险敞口
+
+| 场景 | 概率 (市场) | 概率 (推测) | 结果 |
+|------|------------|-------------|------|
+| 两个都赢 | 2.4% | ~5%? | +$61,140 |
+| Commanders 赢 | ~18% | ~25%? | +$25,527 |
+| Chiefs 赢 | ~9% | ~15%? | +$18,595 |
+| 两个都输 | ~70% | ~55%? | -$11,859 |
+
+---
+
+## 7. 关键策略总结
+
+### 7.1 simonbanza 的投资哲学
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                    simonbanza 投资框架                       │
+├─────────────────────────────────────────────────────────────┤
+│                                                             │
+│  1. 市场选择                                                │
+│     └─ 选择自己有专业知识的领域 (NFL 体育)                  │
+│                                                             │
+│  2. 机会识别                                                │
+│     └─ 寻找市场可能低估的冷门结果                          │
+│                                                             │
+│  3. 入场执行                                                │
+│     └─ 固定限价 + 分批建仓 + 大单吃深度                    │
+│                                                             │
+│  4. 持仓管理                                                │
+│     └─ 零卖出，100% 持有到结算                             │
+│                                                             │
+│  5. 资金管理                                                │
+│     └─ 高集中度，不分散                                    │
+│                                                             │
+└─────────────────────────────────────────────────────────────┘
+```
+
+### 7.2 可学习的要点
+
+| 要点 | 说明 |
+|------|------|
+| **专注领域** | 不追热点，只做熟悉的市场 |
+| **逆向思维** | 当大众看好 A 时，思考 B 是否被低估 |
+| **执行纪律** | 限价单不追涨，分批不冲动 |
+| **持有耐心** | 不因波动卖出，等待最终结果 |
+| **集中投资** | 有信心就下重注，不稀释 |
+
+### 7.3 风险警示
+
+这种策略**不适合所有人**:
+
+1. **高波动**: 单个市场输赢决定大部分收益
+2. **需要专业知识**: 必须比市场更懂某个领域
+3. **心理压力大**: 看着 $10,000 仓位等待结果
+4. **可能连续失败**: 冷门毕竟是冷门
+
+---
+
+## 8. 研究局限性
+
+### 8.1 数据限制
+
+| 限制 | 影响 |
+|------|------|
+| 只能获取最近 100 笔交易 | 无法分析历史已结算市场 |
+| 无法获取历史持仓 | 不知道过去押注了什么 |
+| 无法获取结算记录 | 不知道哪些市场赢了/输了 |
+
+### 8.2 需要进一步研究
+
+1. **获取更多历史交易** - 通过链上数据分析
+2. **分析已结算市场** - 验证逆向投资假设
+3. **比较其他顶级交易者** - 是否有类似模式
+4. **追踪今日结果** - 验证策略有效性
+
+---
+
+## 9. 结论
+
+**simonbanza** 的成功不是偶然。他的策略具有清晰的逻辑：
+
+1. **选择熟悉领域** → 获取信息优势
+2. **逆向押注冷门** → 捕捉市场错误定价
+3. **严格限价执行** → 控制成本
+4. **持有到结算** → 最大化收益
+5. **集中投资** → 不稀释回报
+
+这是一种**高风险高回报**的策略，需要专业知识、心理素质和资金实力支撑。
+
+---
+
+## 附录: 今日交易原始数据
+
+### A. Commanders 主要交易
+
+| 时间 (UTC) | 股数 | 价格 | 金额 | 类型 |
+|------------|------|------|------|------|
+| 13:54:47 | 25,350 | 0.20 | $5,070 | 大单 |
+| 13:34:33 | 3,951 | 0.20 | $790 | 大单 |
+| 13:59:49 | 2,700 | 0.20 | $540 | 大单 |
+| 13:58:49 | 400 | 0.20 | $80 | 中单 |
+| 13:48:13 | 375 | 0.20 | $75 | 中单 |
+
+### B. Chiefs 主要交易
+
+| 时间 (UTC) | 股数 | 价格 | 金额 | 类型 |
+|------------|------|------|------|------|
+| 13:57:27 | 23,584 | 0.11 | $2,594 | 大单 |
+| 13:40:43 | 2,809 | 0.11 | $309 | 大单 |
+| 14:17:17 | 2,499 | 0.11 | $275 | 大单 |
+| 14:01:19 | 226 | 0.11 | $25 | 中单 |
+
+---
+
+*报告生成时间: 2025-12-25 15:00 UTC*
+*数据来源: Polymarket MCP API*