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赔率与上下文分析相结合。当用户要求“研究”某个市场或希望获得比单纯赔率更深入的分析时:
- 获取市场数据——使用搜索或事件命令
- 分析赔率——市场隐含了什么?是否存在优势?
- 提供背景信息——利用您的知识解释驱动赔率的原因
- 显示历史走势——如果CLI可用,拉取价格历史
- 与共识比较——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"
当用户要求“比较市场”或“并排赔率”时:
- 搜索用户提到的每个市场
- 以比较表格格式呈现赔率
- 注意成交量差异(成交量越高,赔率越可靠)
- 标记任何明显的不一致之处(例如,概率之和本应接近100%但实际不是)
- 突出显示相关结果之间的价差
将比较格式化为表格:
市场比较: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个十六进制字符)。提示用户检查地址。
- 无数据 - 新钱包或非活跃钱包可能没有头寸或交易历史。返回空结果而非错误。
故障排除
常见问题
-
说它有,但看不到市场?
- 运行
python3 {baseDir}/scripts/polymarket.py trending查看活跃市场列表 - 使用
search命令按关键词查找特定市场
- 运行
-
CLI安装了但交易不起作用?
- 首先运行
polymarket wallet create设置钱包 - 然后运行
polymarket approve set批准USDC支出 - 如果不确定,运行
polymarket wallet show查看您的地址
- 首先运行
-
获取价格历史错误?
- 从Gamma API获取代币ID:搜索市场并注意条件ID或代币ID
- 从
event命令输出中复制条件ID
-
WebSocket无法连接?
- 确保您的网络允许WebSocket连接
- 某些企业防火墙会阻止WebSocket流量
- 如果不需要,可回退到轮询模式
-
命令输出为JSON?
- 将
--output json附加到任何CLI命令后 - 示例:
polymarket wallet balance --output json - 可用于脚本和管道操作
- 将
提示与技巧
- 市场发现:使用
trending发现新市场,使用category按主题深入探索 - 研究流程:在交易之前,使用研究模式分析市场
- 比较模式:在投入资金之前并排比较相关市场
- 投资组合检查:经常使用投资组合仪表板检查您的表现
- 订单簿深度:在下大单之前检查流动性
- 价格历史:在评估概率时查看价格趋势(而不仅仅是当前价格)
- 仅预览:在提交订单前始终预览——使用没有
--confirm的命令查看将要发生什么 - 使用
--output json:用于脚本、自动化、工作流集成和聊天上下文管理