Poly Master v3 — Polymarket 预测市场 + Poly Master 对冲策略#

Powered by Antalpha AI — Polymarket 聚合交易、跟单与 LLM 驱动对冲套利

---

Overview#

Poly Master v3 在交易、跟单和对冲策略基础上，新增 Antalpha 深度数据层。Agent 可以在用户跟单、查看持仓、评估巨鲸信号、分析市场热度时，用更真实的钱包胜率、PnL、已结算市场数量和事件资金热度辅助解释。

V3 核心能力#

能力说明🔮 对冲策略扫描LLM 分析市场逻辑蕴含关系，输出 T1/T2/T3 分级套利信号🔎 市场全文搜索poly-master-search-market 多语言搜索长尾市场（事件/球队/候选人/slug）🧠 Antalpha 钱包画像查询钱包 PnL、胜率、最大盈利、已结算市场活动👥 真实交易员榜单poly-master-traders 返回真实 winRate 与 settledMarkets🔥 事件资金热度poly-trending / poly-intel 可展示 totalVolume、uniqueTraders、top holders🏗️ Builder Program 接入所有 CLOB 订单通过 Polymarket Builder Program 路由，享受优先执行和免 Gas 操作⛽ 免 Gas 操作Relayer 代付链上 Gas，降低交易摩擦

---

Architecture#

text

User ←→ AI Agent ←→ Antalpha MCP Server ←→ Polymarket APIs
                          ↕
              ┌───────────┼──────────────┐
              ▼           ▼              ▼
       PolyMasterStrategy  LlmProxy    BuilderModule
       (对冲扫描引擎)   (计量计费)   (X-Builder-Key)
              ↕           ↕              ↕
         Gamma/CLOB    OpenAI API   CLOB/Relayer

• Zero custody: 私钥不离开用户钱包
• MCP Protocol: Streamable HTTP (MCP 2024-11-05)
• Chain: Polygon Mainnet (Chain ID 137)
• Currency: USDC.e ( 0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174)
• Supported Wallets: MetaMask, OKX Wallet, Trust Wallet, TokenPocket

---

MCP Tools Reference#

Registration（首次必须）#

ToolDescriptionantalpha-register注册 agent，返回 agent_id + api_key。仅调用一次，持久化两个值。

Market Discovery#

ToolParametersDescriptionpoly-trending``agent_id, limit?, category?热门市场（按 24h 成交量），缓存命中时可附加 Antalpha 资金热度poly-new``agent_id, limit?, hours?, category?最近创建的市场poly-market-info``agent_id, market_id市场完整信息：价格/成交量/Token ID/结果列表poly-master-search-market``agent_id, query, lang?, limit?, min_liquidity?, include_closed?自由文本搜索市场（按名称/球队/国家/候选人/事件标题/slug）。当 poly-trending/ poly-new 未返回用户问到的具体事件（尤其多结果事件下的长尾结果）时调用此工具。支持 zh-CN/zh-TW/en/ja/ko，内部翻译后查询

Direct Trading#

ToolParametersDescriptionpoly-buy``agent_id, market_id, outcome, amount_usdc, wallet_address, proxy_wallet, price?买入结果代币。不含 price = 市价单；含 price = 限价单poly-sell``agent_id, market_id, outcome, size, wallet_address, proxy_wallet卖出结果代币poly-confirm``agent_id, order_id查询订单签名状态 + CLOB 成交状态（ pending_signature / submitted / matched / failed），同时自动修复 signed 但未更新为 submitted 的订单poly-master-orders``agent_id, status?, limit?订单列表，支持按状态过滤（ pending_signature/ submitted/ matched/ failed/ cancelled）poly-history``agent_id, proxy_wallet, limit?链上历史成交记录（来自 Polymarket data API）

Copy Trading#

ToolParametersDescriptionpoly-master-traders``agent_id, limit?, sort_by?顶级交易员列表，v3 可返回真实 winRate 与 settledMarkets``poly-master-follow``agent_id, address, copyRatio跟随/取消跟随交易员，设置跟单比例（0.1 = 10%）poly-master-status``agent_id跟单状态：已关注交易员 + 最近跟单订单poly-master-risk``agent_id, stopLossPercent?, takeProfitPercent?, maxPositionPerMarket?, maxTotal?查看/更新风控参数poly-master-pnl``agent_id, period?PnL 报告（day/week/month），按交易员分组poly-master-orders``agent_id, status?, limit?跟单/普通订单列表

Portfolio#

ToolParametersDescriptionpoly-positions``agent_id, proxy_wallet当前持仓：成本/市值/未实现 PnL；缓存命中时附加 Antalpha 钱包数据poly-history``agent_id, proxy_wallet, limit?交易历史记录poly-master-orders``agent_id, status?, limit?查未成交/挂单：用 status 过滤（如 status: "submitted"）

---

V3 Antalpha Data Tools#

什么时候使用 poly-intel#

用户意图推荐 action用户示例跟单前判断钱包质量wallet-profile“这个钱包 0xABC... 值得跟单吗？”找表现最稳定的交易员leaderboard“按胜率和已结算市场数看顶级交易员。”看某事件背后是谁在持仓top-holders“这个 event_id 的 top holders 是谁？”看全局资金热点hotspots“现在 Polymarket 哪些事件资金最热？”看网络级活动network-stats“给我一个 Polymarket 网络活动概览。”

poly-intel 参数规则#

ActionRequired parameters说明wallet-profile``address钱包画像：PnL、胜率、最大盈利、已结算市场leaderboardnone交易员榜单top-holders``event_id事件级 top holdershotspotsnone全局热点事件network-statsnone网络活动概览

数据可用性解释#

poly-intel 和被富化的老工具都会返回 meta。Agent 必须按以下方式解释：

• meta.cached=true + meta.dataAvailable=true：可以正常总结深度数据字段。
• meta.dataAvailable=false：说明目前没有可用 Polymarket 深度活动，不要把它说成“安全”或“风险低”。
• meta.queuedForEnrichment=true：告诉用户后台正在补全，建议稍后再问；同时展示当前已有的 Polymarket/Gamma 数据。

钱包画像输出建议#

text

🧠 Polymarket 钱包画像 — {address}

📊 胜率：{winRate}%（基于已结算市场）
🏁 已结算市场：{settledMarkets}
💰 总 PnL：{totalPnl}
🏆 最大盈利：{question} / {outcome} / {pnl}
🐋 巨鲸标签：{isWhale}

解读：{用 2-3 句话说明是否值得继续观察、是否适合跟单、信息是否完整}

由 Antalpha AI 提供聚合服务

---

V3 Poly Master Strategy Tools#

策略原理：Poly Master 基于逻辑蕴含而非市场相关性寻找套利机会。若 "A=YES 必然导致 B=YES"，则存在接近无风险的双腿对冲结构（totalCost < 1）。

策略工具#

ToolParametersDescriptionpoly-master-strategy-scan``agent_id, limit?, min_tier?触发一轮市场扫描，返回按覆盖率排序的对冲信号列表； 每条信号已含完整详情（双腿 position、targetPrice/coverPrice、totalCost、coverage、expectedProfit、availableSize、tier、reasoning），无需再单独查询

信号结构说明#

text

HedgeSignal {
  targetMarketId    # 目标市场 ID
  targetPosition    # "YES" | "NO"
  coverMarketId     # 对冲市场 ID
  coverPosition     # "YES" | "NO"
  metrics {
    targetPrice     # 目标腿价格（string, 精度保留）
    coverPrice      # 对冲腿价格（string）
    totalCost       # 两腿总成本，必须 < 1.0
    availableSize   # 最小可交易流动性（盘口最小挂单量）
    expectedProfit  # 预期利润（1 - totalCost）
    coverage        # 覆盖率，必须 ≥ 0.85
    tier            # "T1" (≥0.95) | "T2" (≥0.90) | "T3" (≥0.85)
  }
  reasoning         # LLM 推理依据（自然语言）
  builderAttributed # true = 已携带 Builder 归因头
}

Tier 分级解读#

TierCoverage说明T1≥ 0.95极强逻辑蕴含，几乎无风险T2≥ 0.90强逻辑蕴含，低风险T3≥ 0.85中等蕴含，需关注流动性

---

Agent Instructions#

1. 首次使用#

text

1. 调用 antalpha-register → 获取 agent_id + api_key
2. 持久化 agent_id 和 api_key（后续所有调用均需要）
3. 询问用户钱包地址 (wallet_address) 和代理钱包地址 (proxy_wallet)

2. 普通交易流程#

text

poly-trending / poly-new → 发现市场
poly-market-info → 查看详情
poly-buy / poly-sell → 生成签名链接
展示订单预览格式（含二维码）→ 用户在钱包内打开签名

3. Antalpha 数据辅助流程#

当用户说“这个钱包怎么样”“这个交易员值得跟吗”“这个市场背后资金热不热”“这个巨鲸有 Polymarket 表现吗”时，优先使用 v3 数据能力：

text

钱包/交易员评估：
poly-intel({ action: "wallet-profile", address })
→ 若 dataAvailable=true，总结 winRate / settledMarkets / totalPnl / biggestWin
→ 若 queuedForEnrichment=true，说明后台正在补全，先给已有信息

榜单/跟单评估：
poly-master-traders({ agent_id, sort_by: "winRate" })
→ 展示 winRate 与 settledMarkets，强调 settledMarkets 是已结算市场数，不是交易笔数

热门市场分析：
poly-trending({ agent_id, limit })
→ 如返回 Antalpha 资金热度，补充 totalVolume / uniqueTraders

用户提示语示例：

• “帮我判断这个钱包是否值得跟单：0xABC...”
• “列出胜率高且已结算市场多的 Polymarket 交易员。”
• “这个市场有哪些 top holders？”
• “这个巨鲸在 Polymarket 上有历史盈利吗？”

4. Poly Master 对冲策略流程（只读分析）#

⚠️ 当前 MCP 仅支持对冲机会的扫描与分析；实盘执行（双腿下单）尚未通过 MCP 开放。 待后端上线执行能力后再补充下单流程。请勿向用户承诺可经本 skill 自动完成对冲下单。

text

步骤 1: 调用 poly-master-strategy-scan({ agent_id, limit: 5 })
        → 返回按覆盖率排序的信号列表，每条信号已含完整详情
          （双腿 target/cover position、targetPrice/coverPrice、totalCost、
           coverage、expectedProfit、availableSize、tier、reasoning）

步骤 2: 展示信号列表（按 Tier 分组，显示 totalCost/coverage/tier/expectedProfit）
        → scan 输出即为信号详情，无需再单独查询单条信号

⚠️ 展示与解读规则：

• totalCost ≥ 1 的信号无套利空间，应明确标注「不具备套利条件」
• availableSize 为当前盘口最小可成交流动性，需提示用户实际可执行规模受限于此
• coverage / tier 越高逻辑蕴含越强；T3 信号需特别提示流动性风险
• 不得向用户承诺「无风险」，仅以 expectedProfit = 1 − totalCost 客观呈现理论利润

5. Portfolio 查询（备用公开 API）#

当 poly-positions 未部署时：

text

GET https://data-api.polymarket.com/positions?user={proxy_wallet}

---

Mandatory Output Formats#

订单预览格式（所有 poly-buy / poly-sell 必须使用）#

⚠️ 硬性规则：所有字段值必须来自 MCP 响应，不允许填写硬编码数据。

text

📋 {market}
🎯 方向：{side} {outcome}
💰 价格：${price}/份
📦 数量：{size} 份
💵 总计：${totalUsdc} USDC
📊 滑点：{slippage}%
🔗 签名页面：{signUrl}
[二维码图片 — 必须生成并附带]

由 Antalpha AI 提供聚合交易服务

发送前检查：✅ 7 行都有 ✅ 二维码已生成 ✅ 品牌 footer ✅ 无额外注释

对冲信号列表格式#

text

🔮 Poly Master 对冲信号 — {扫描时间}

共发现 {n} 个信号

⭐⭐⭐ T1 信号（Coverage ≥ 0.95）
━━━━━━━━━━━━━━━━━━━━━━━━
1️⃣ Signal #{id}
   📌 目标：{targetMarketQuestion} → {targetPosition}
   🔗 对冲：{coverMarketQuestion} → {coverPosition}
   💰 总成本：{totalCost} USDC（利润空间：{expectedProfit} USDC）
   📊 覆盖率：{coverage} | 可用流动性：{availableSize} USDC
   💡 {reasoning}

⭐⭐ T2 信号 / ⭐ T3 信号
...

由 Antalpha AI Poly Master 策略引擎提供

对冲执行格式（两腿）#

text

⚡ 对冲执行 — Signal #{id}

🦵 第一腿（Target）
📋 {targetMarket}
🎯 方向：BUY {targetPosition}
💰 价格：${targetPrice}/份 | 数量：{size} 份
🔗 签名页面：{signUrl_leg1}
[二维码 1]

🦵 第二腿（Cover）
📋 {coverMarket}
🎯 方向：BUY {coverPosition}
💰 价格：${coverPrice}/份 | 数量：{size} 份
🔗 签名页面：{signUrl_leg2}
[二维码 2]

⚠️ 请先完成第一腿签名，再签第二腿

由 Antalpha AI Poly Master 策略引擎提供

Portfolio 格式#

text

🎯 Polymarket 持仓报告

1️⃣ {event_title}
   方向：{outcome}
   持仓：{size} 份 | 均价 ${avg_price}
   现价：${cur_price} | 市值 ${current_value}
   盈亏：${pnl} ({pnl_percent}%)
   到期：{end_date}

📊 汇总：总投入 ${total_cost} | 市值 ${total_value} | 盈亏 ${total_pnl} ({total_pnl_percent}%)

由 Antalpha AI 提供聚合服务

---

Risk Defaults#

ParameterDefaultDescriptionSlippage Tolerance5%市价单最大价格偏差Daily Bet Limit$2,000每日最大交易额Per-Market Limit$500单市场最大仓位Large Order Threshold$1,000需显式确认Copy Trading Stop-Loss20%自动暂停阈值Poly Master Min Coverage0.85T3 最低覆盖率（低于此不展示）Poly Master Max PositionavailableSize不超过盘口最小流动性

---

Builder Program#

PolyMaster V3 所有 CLOB 订单均通过 Polymarket Builder Program 路由：

• X-Builder-Key：每笔订单必须携带（缺失则拒单）
• Relayer：用户享受免 Gas 链上操作（需 Safe/Proxy 钱包）

---

How Signing Works#

1. 🔔 Agent 通过 MCP 生成签名 URL
2. 🌐 用户在钱包内置浏览器（MetaMask/OKX/Trust/TokenPocket）打开链接
3. 🔐 页面展示订单详情（市场/方向/价格/数量）
4. ✅ 用户点击"签名" — 钱包弹出 EIP-712 类型化数据签名
5. 📤 签名提交到服务器，订单发往 Polymarket CLOB

安全保障：私钥不离开钱包，签名页面仅请求特定订单数据的签名。

---

Polymarket SDK Reference（后端集成参考）#

• EIP-712 domain.name: "Polymarket CTF Exchange"（不是 "ClobExchange"）
• signatureType: 2（POLY_GNOSIS_SAFE）— 用户通过 GnosisSafe 代理钱包交易
• maker: proxy wallet | signer: EOA wallet
• HMAC owner: API Key（非钱包地址）
• API Key: 一次性 createApiKey()，后续用 deriveApiKey()
• USDC.e (Polygon): 0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174

---

Brand Attribution（必须）#

⚠️ 所有用户可见输出必须以品牌 footer 结尾：

• 中文： 由 Antalpha AI 提供聚合服务
• 英文： Powered by Antalpha AI

适用范围：市场列表、订单预览、持仓报告、PnL 报告、跟单状态、交易员排名、对冲信号列表、策略看板 —— 无例外。

---

Files#

text

poly-master/
├── SKILL.md              # Agent 指令（本文件）
├── README.md             # 项目对外说明
├── docs/
│   └── quickstart.md     # 用户快速上手
├── references/
│   └── trade-page.html   # 浏览器签名页模板
└── scripts/              # 本地测试脚本

---

Built by Antalpha AI | MCP: https://mcp-skills.ai.antalpha.com/mcp | v3.0.2

---

Changelog#

• v3.0.2 — 与当前 MCP 服务对齐（精选面向用户版）：新增市场发现工具 poly-master-search-market；移除内部计量/演练工具 poly-master-strategy-metrics、 poly-master-strategy-dry-run（及对应策略看板章节）；校正 poly-positions / poly-history 参数为 proxy_wallet， poly-master-orders 去除 wallet_address、补 limit 与状态枚举。