Communitygithub.com

mvanhorn/clawdbot-skill-polymarket

随时随地掌握Polymarket预测市场——查看赔率、追踪投资组合、借助AI分析研究市场、比较市场并进行交易。涵盖全部4个Polymarket API:Gamma、CLOB、Data API、RTDS WebSocket以及Bridge。只读模式无需任何设置立即可用。这是ClawHub上最全面的预测市场技能。

clawdbot-skill-polymarket 是什么?

该技能为AI助手(如Claude Code、Cursor、Codex)提供与Polymarket预测市场交互的全面能力。它允许用户通过自然语言查询赔率、研究事件、比较市场、追踪投资组合、流式传输实时数据、跨链桥接资金以及执行交易,所有这些操作都可在终端内完成。该技能通过一个Python脚本包装器,利用了Polymarket的所有五个API层:用于浏览的公共Gamma API、用于交易的CLOB、用于投资组合分析的Data API、用于实时更新的RTDS WebSocket以及用于跨链转账的Bridge。只读命令(如搜索趋势市场、按类别筛选以及市场研究)无需任何设置即可立即运行。对于交易、订单簿数据、价格历史和投资组合功能,用户需要安装Polymarket CLI(一个Rust二进制文件)并配置一个钱包。该技能还包含强大的错误处理机制,例如处理Gamma API的速率限制(支持IPv6轮换)以及从CLI故障中优雅地恢复。

兼容平台~Claude Code~Codex CLI✓Cursor
npx skills add mvanhorn/clawdbot-skill-polymarket

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

Polymarket

在终端中查询Polymarket预测市场并进行交易。浏览赔率、研究事件、比较市场、追踪投资组合、流式传输实时数据、跨链桥接资金以及执行交易——全部通过自然语言完成。

Polymarket公开了4个独立的API以及Gamma便利层。本技能覆盖所有这些API。

设置

只读命令立即可用(无需安装)。浏览、搜索、趋势、分类、市场研究和比较模式均使用公共Gamma API。

对于交易、订单簿、价格历史和高级功能,请安装Polymarket CLI(Rust二进制文件,v0.1.5+):

brew install polymarket/tap/polymarket-cli

要进行交易,请设置一个钱包:

polymarket wallet create
polymarket approve set

或者手动使用您的私钥配置 ~/.config/polymarket/config.json。详情请参阅CLI文档。

该CLI还提供了一个交互式REPL:

polymarket shell

在任何CLI命令上使用 --output json 可获取机器可读的输出,适用于脚本和管道操作。

命令

浏览市场(无需CLI)

# 趋势/活跃市场(按24小时成交量排序)
python3 {baseDir}/scripts/polymarket.py trending

# 显示更多结果的趋势市场
python3 {baseDir}/scripts/polymarket.py trending --limit 20

# 按关键词搜索市场
python3 {baseDir}/scripts/polymarket.py search "trump"

# 按slug获取特定事件
python3 {baseDir}/scripts/polymarket.py event "fed-decision-in-october"

# 按分类获取市场
python3 {baseDir}/scripts/polymarket.py category politics
python3 {baseDir}/scripts/polymarket.py category crypto
python3 {baseDir}/scripts/polymarket.py category sports
python3 {baseDir}/scripts/polymarket.py category tech
python3 {baseDir}/scripts/polymarket.py category entertainment
python3 {baseDir}/scripts/polymarket.py category science
python3 {baseDir}/scripts/polymarket.py category business

趋势市场仪表板(无需CLI)

显示Polymarket上热门市场的分类仪表板。将趋势市场与分类筛选器结合使用,以构建完整概览。

# 完整趋势仪表板——按顺序运行这些命令以构建全貌:
python3 {baseDir}/scripts/polymarket.py trending --limit 10
python3 {baseDir}/scripts/polymarket.py category politics --limit 5
python3 {baseDir}/scripts/polymarket.py category crypto --limit 5
python3 {baseDir}/scripts/polymarket.py category sports --limit 5
python3 {baseDir}/scripts/polymarket.py category tech --limit 5

当用户要求“仪表板”或“概览”时,运行所有分类查询,并按部分分组展示结果,使用清晰的标题。包括每个市场的成交量和当前赔率。

市场研究模式(无需CLI)

市场研究将Polymarket赔率与上下文分析相结合。当用户要求“研究”某个市场或希望获得比单纯赔率更深入的分析时:

  1. 获取市场数据——使用搜索或事件命令
  2. 分析赔率——市场隐含了什么?是否存在优势?
  3. 提供背景信息——利用您的知识解释驱动赔率的原因
  4. 显示历史走势——如果CLI可用,拉取价格历史
  5. 与共识比较——Polymarket赔率与民调、专家意见或其他预测市场相比如何?
# 第1步:找到市场
python3 {baseDir}/scripts/polymarket.py search "fed rate cut"

# 第2步:获取详细事件数据
python3 {baseDir}/scripts/polymarket.py event "fed-rate-decision-march-2026"

# 第3步:如果CLI可用,获取价格历史以显示趋势
python3 {baseDir}/scripts/polymarket.py price-history TOKEN_ID --interval 1d

# 第4步:检查订单簿深度以评估流动性
python3 {baseDir}/scripts/polymarket.py book TOKEN_ID

收集数据后,将研究综合成一份结构化报告:

  • 当前赔率:是与否的百分比及其含义
  • 成交量与流动性:该市场中有多少资金,流动性是否足以进行交易?
  • 趋势:赔率是在上升还是下降?近期是否有任何异常波动?
  • 背景信息:哪些现实世界的事件或数据点正在驱动赔率?
  • 关键日期:市场何时结算?是否有即将到来的催化剂?
  • 风险因素:什么可能导致突然的价格波动?

市场比较模式(无需CLI)

并排比较相关市场。适用于发现套利机会、理解条件概率,或仅仅了解不同结果之间的关系。

# 通过搜索比较两个或多个相关市场
python3 {baseDir}/scripts/polymarket.py search "trump 2028"
python3 {baseDir}/scripts/polymarket.py search "desantis 2028"
python3 {baseDir}/scripts/polymarket.py search "newsom 2028"

当用户要求“比较市场”或“并排赔率”时:

  1. 搜索用户提到的每个市场
  2. 以比较表格格式呈现赔率
  3. 注意成交量差异(成交量越高,赔率越可靠)
  4. 标记任何明显的不一致之处(例如,概率之和本应接近100%但实际不是)
  5. 突出显示相关结果之间的价差

将比较格式化为表格:

市场比较:2028年总统选举

| 候选人     | 是     | 成交量  | 流动性 |
|-------------|---------|---------|-----------|
| Trump       | 32.5%   | $4.2M   | 高        |
| DeSantis    | 18.1%   | $1.8M   | 中        |
| Newsom      | 12.4%   | $890K   | 中        |
| Harris      | 8.7%    | $2.1M   | 中        |

投资组合仪表板(需要CLI + 钱包)

通过单一视图查看您的完整投资组合,包括持仓、盈亏和未成交订单。

# 查看所有未平仓头寸
python3 {baseDir}/scripts/polymarket.py positions

# 查看特定钱包的头寸
python3 {baseDir}/scripts/polymarket.py positions --address 0xYOUR_WALLET

# 检查USDC余额
python3 {baseDir}/scripts/polymarket.py wallet-balance

# 检查特定代币的余额
python3 {baseDir}/scripts/polymarket.py wallet-balance --token TOKEN_ID

# 列出所有未成交订单
python3 {baseDir}/scripts/polymarket.py orders

当用户要求“投资组合仪表板”或“我的表现如何”时,运行所有三个命令(positions, wallet-balance, orders)并给出统一视图:

  • 持仓:每个头寸包含当前市场价格、您的开仓价(如果可用)以及未实现盈亏
  • USDC余额:可用于新交易的现金
  • 未成交订单:待处理的限价订单,包含价格和数量
  • 投资组合总价值:持仓价值 + USDC余额

订单簿与价格(需要CLI,无需钱包)

# 某代币的订单簿
python3 {baseDir}/scripts/polymarket.py book TOKEN_ID

# 价格历史(时间间隔:1m, 1h, 6h, 1d, 1w, max)
python3 {baseDir}/scripts/polymarket.py price-history TOKEN_ID --interval 1d

# 带有特定数据点数量的价格历史
python3 {baseDir}/scripts/polymarket.py price-history TOKEN_ID --interval 1h --fidelity 48

钱包(需要CLI)

polymarket wallet create
polymarket wallet show
polymarket wallet balance
polymarket wallet balance --token TOKEN_ID

交易(需要CLI + 钱包)

所有交易都需要 --confirm 才能执行。没有该标志,订单仅作为预览。这是一项安全功能——您始终能在操作发生之前看到将会发生什么。

成本与费用透明度

在执行任何交易之前,本技能会显示:

  • 订单类型:限价单或市价单
  • 方向:买入或卖出
  • 价格:您的限价(或市价单的“市场价”)
  • 数量:股份数量
  • 预估成本:限价单为价格 × 数量,市价单为美元金额
  • Polymarket费用:Polymarket在CLOB上不收取交易手续费
  • Gas费用:链上操作(批准、拆分、赎回)需要在Polygon上使用MATIC作为燃料。典型Gas费用:$0.01-0.05
# 预览限价单(--confirm 不存在 = 仅预览)
python3 {baseDir}/scripts/polymarket.py trade buy --token TOKEN_ID --price 0.50 --size 10

# 执行限价单
python3 {baseDir}/scripts/polymarket.py --confirm trade buy --token TOKEN_ID --price 0.50 --size 10

# 卖出限价单
python3 {baseDir}/scripts/polymarket.py --confirm trade sell --token TOKEN_ID --price 0.70 --size 10

# 市价单:以当前价格买入5美元
python3 {baseDir}/scripts/polymarket.py --confirm trade buy --token TOKEN_ID --market-order --amount 5

# 仅挂单限价单(仅挂单,从不吃单——2026年1月+)
python3 {baseDir}/scripts/polymarket.py --confirm trade buy --token TOKEN_ID --price 0.45 --size 20 --post-only

订单与持仓(需要CLI + 钱包)

# 列出未成交订单
python3 {baseDir}/scripts/polymarket.py orders

# 取消特定订单
python3 {baseDir}/scripts/polymarket.py --confirm orders --cancel ORDER_ID

# 取消所有订单
python3 {baseDir}/scripts/polymarket.py --confirm orders --cancel all

# 查看持仓
python3 {baseDir}/scripts/polymarket.py positions
python3 {baseDir}/scripts/polymarket.py positions --address 0xYOUR_WALLET

API参考

Polymarket公开了4个独立的API以及Gamma便利层。每个API服务于不同的目的。

1. Gamma API (gamma-api.polymarket.com) - 公共,无需认证

用于浏览和搜索市场的高级便利API。所有只读命令均使用此API。

  • 基础URL: https://gamma-api.polymarket.com
  • GET /events - 列出事件(参数:order, ascending, closed, limit, tag_slug)
  • GET /search - 搜索市场(参数:query, limit)
  • GET /events/slug/{slug} - 按slug获取事件
  • GET /comments - 列出并筛选市场的评论
  • GET /profiles/{address} - 公共用户资料
  • GET /series - 分组的事件集合(例如,“2028年选举”系列)
  • GET /sports - 体育元数据,包括队伍、比赛和结算标准
  • GraphQL: POST /query - 支持订阅的完整GraphQL端点

2. CLOB API (clob.polymarket.com) - 交易

用于所有交易操作的中央限价订单簿API。由Polymarket CLI封装。

  • 基础URL: https://clob.polymarket.com
  • GET /prices-history - 历史价格(时间间隔:1m, 1h, 6h, 1d, 1w, max)
  • GET /spread - 某代币的买卖价差
  • GET /fee-rate - 费用结构详情
  • GET /rewards - 每日做市商/吃单者收益
  • POST /order - 下订单
  • POST /orders - 批量订单(每次请求最多15个)
  • DELETE /order/{id} - 取消订单
  • 订单评分 - 在下单前检查做市商返利资格
  • 仅挂单订单(2026年1月)- 仅挂单,从不跨越价差
  • 心跳API(2026年1月):
    • POST /heartbeat - 必须在10秒内发送,否则所有未成交订单自动取消
    • 由做市商用于维持订单存在
    • 如果心跳中断,该API密钥的所有挂单将被取消

3. Data API (data-api.polymarket.com) - 投资组合与分析

用于投资组合追踪、交易历史和市场分析的专用API。公共端点无需认证。

  • 基础URL: https://data-api.polymarket.com
  • GET /positions?user={address} - 当前未平仓头寸
    • 排序方式:TOKENS, CURRENT, INITIAL, CASHPNL, PERCENTPNL
  • GET /closed-positions?user={address} - 历史已平仓头寸
  • GET /activity?user={address} - 活动动态
    • 类型:TRADE, SPLIT, MERGE, REDEEM, REWARD
  • GET /value?user={address} - 投资组合估值(美元)
  • GET /trades - 交易历史
    • 筛选条件:user, market, side
    • 每页最多500条结果
  • GET /holders?market={conditionId} - 某市场的主要代币持有者
  • GET /oi - 跨市场未平仓合约
  • GET /volume - 跨市场交易量
  • GET /leaderboard - 交易者排名(可配置时间段)

使用Data API进行投资组合仪表板和分析。它提供比CLOB API更丰富的头寸数据,包括盈亏计算和活动历史。

4. RTDS WebSocket (wss://ws-live-data.polymarket.com) - 实时流

通过WebSocket进行实时数据流。订阅主题以获取实时更新,无需轮询。

  • URL: wss://ws-live-data.polymarket.com
  • 协议: 通过WebSocket的JSON消息
  • 主题:
    • comments - 实时评论活动
      • 事件:comment_created, comment_removed, reaction_created, reaction_removed
    • crypto_prices - 实时加密货币价格
      • 资产:BTC, ETH, SOL, XRP
      • 数据源:Binance + Chainlink预言机
  • 动态订阅管理 - 在单个连接内动态订阅和取消订阅主题
  • 适用于构建实时仪表板、监控评论情绪或追踪进入5分钟加密货币市场的加密货币价格

5. Bridge API (bridge.polymarket.com) - 跨链充值与提现

跨多条链将资金桥接进出Polymarket。

  • 基础URL: https://bridge.polymarket.com
  • POST /deposit - 生成充值地址
    • 支持的链:EVM(以太坊、Polygon、Arbitrum等)、Solana、比特币
    • 返回所选链的唯一充值地址
  • POST /withdraw(2026年1月)- 将USDC.e桥接到任何支持的链
  • GET /supported-assets - 列出所有支持的资产和链
  • GET /quote - 获取跨链桥接报价(费用、预估时间)

当用户需要在无需离开终端的情况下将资金转入或转出Polymarket时,使用Bridge API。


新市场类型

  • 5分钟加密货币市场(2026年2月)- 针对BTC/ETH/SOL价格波动的超短期市场。由RTDS crypto_prices数据提供。
  • 体育市场 - 通过Gamma /sports 端点提供专用体育元数据,包括队伍信息、比赛日程和结算标准。

错误恢复

API错误(Gamma API)

如果Gamma API返回错误或无法访问:

  • HTTP 429(速率限制) - 等待15秒后重试。如果持续限流,脚本会使用IPv6轮换(如果可用)。
  • HTTP 500(服务器错误) - 指数退避重试(2秒、4秒、8秒)。最多重试3次。
  • 空响应 - 某些查询可能没有结果。始终检查空列表并提示用户。
  • 网络超时 - 如果Gamma API在10秒内无响应,提示用户稍后重试。

CLI错误

如果Polymarket CLI未安装或失败:

  • 命令未找到 - 如果CLI未安装,建议用户安装它:brew install polymarket/tap/polymarket-cli
  • CLI标准错误 - 如果CLI命令失败,捕获标准错误并显示给用户。常见错误包括:
    • 钱包未配置:需要运行 polymarket wallet create
    • 配额不足:需要批准更多USDC
    • RPC错误:Polygon RPC暂时不可用,稍后重试
  • CLI超时 - CLI命令应在30秒后超时

Data API错误

  • 无效地址 - 验证以太坊地址格式(以0x开头,40个十六进制字符)。提示用户检查地址。
  • 无数据 - 新钱包或非活跃钱包可能没有头寸或交易历史。返回空结果而非错误。

故障排除

常见问题

  1. 说它有,但看不到市场?

    • 运行 python3 {baseDir}/scripts/polymarket.py trending 查看活跃市场列表
    • 使用 search 命令按关键词查找特定市场
  2. CLI安装了但交易不起作用?

    • 首先运行 polymarket wallet create 设置钱包
    • 然后运行 polymarket approve set 批准USDC支出
    • 如果不确定,运行 polymarket wallet show 查看您的地址
  3. 获取价格历史错误?

    • 从Gamma API获取代币ID:搜索市场并注意条件ID或代币ID
    • 从 event 命令输出中复制条件ID
  4. WebSocket无法连接?

    • 确保您的网络允许WebSocket连接
    • 某些企业防火墙会阻止WebSocket流量
    • 如果不需要,可回退到轮询模式
  5. 命令输出为JSON?

    • 将 --output json 附加到任何CLI命令后
    • 示例:polymarket wallet balance --output json
    • 可用于脚本和管道操作

提示与技巧

  • 市场发现:使用 trending 发现新市场,使用 category 按主题深入探索
  • 研究流程:在交易之前,使用研究模式分析市场
  • 比较模式:在投入资金之前并排比较相关市场
  • 投资组合检查:经常使用投资组合仪表板检查您的表现
  • 订单簿深度:在下大单之前检查流动性
  • 价格历史:在评估概率时查看价格趋势(而不仅仅是当前价格)
  • 仅预览:在提交订单前始终预览——使用没有 --confirm 的命令查看将要发生什么
  • 使用 --output json:用于脚本、自动化、工作流集成和聊天上下文管理

相关技能