关于 polymarket
Polymarket — Prediction Market Data 通过 Polymarket 的公开 REST API 查询预测市场数据,适合查看事件概率、价格和交易活动。接口只读且无需身份验证,可进一步查询订单簿和价格历史。
主要功能
- 01搜索和浏览事件及市场
- 02查询市场价格与概率
- 03查看订单簿和价格历史
- 04查询交易与未平仓量
- 05公开 REST API 只读访问
适用场景
- 01比较事件结果的市场概率
- 02查看市场价格和成交量
- 03追踪预测市场价格变化
- 04查询市场订单簿或历史
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ nousresearch/ hermes-agent --skill polymarket安装后在 Claude Code 中输入/polymarket确认已加载。
附带文件references/api-endpoints.mdscripts/polymarket.py
详细介绍
Polymarket — 预测市场数据
通过 Polymarket 的公共 REST API 查询预测市场数据。 所有端点均为只读,无需身份验证。
完整的端点参考和 curl 示例,请参阅 references/api-endpoints.md。
适用场景
- 用户询问预测市场、投注赔率或事件概率
- 用户想知道“X 发生的概率有多大?”
- 用户特别询问 Polymarket
- 用户想查看市场价格、订单簿数据或价格历史
- 用户要求监控或追踪预测市场动态
核心概念
- 事件包含一个或多个市场(一对多关系)
- 市场的结果为二元,Yes/No 价格介于 0.00 和 1.00 之间
- 价格即概率:价格为 0.65 表示市场认为发生的可能性为 65%
outcomePrices字段:JSON 编码的数组,例如["0.80", "0.20"]clobTokenIds字段:JSON 编码的两个代币 ID 数组 [Yes, No],用于价格/订单簿查询conditionId字段:用于查询价格历史的十六进制字符串- 交易量以 USDC(美元)计
三个公共 API
- Gamma API,位于
gamma-api.polymarket.com— 发现、搜索、浏览 - CLOB API,位于
clob.polymarket.com— 实时价格、订单簿、历史记录 - Data API,位于
data-api.polymarket.com— 交易、未平仓量
典型工作流
当用户询问预测市场赔率时:
- 搜索:使用 Gamma API 的 public-search 端点搜索用户的查询
- 解析:解析响应,提取事件及其嵌套市场
- 展示:提供市场问题、当前价格(以百分比表示)和交易量
- 深入查询:如用户需要,使用 clobTokenIds 查询订单簿,使用 conditionId 查询历史记录
展示结果
将价格格式化为百分比,以便于阅读:
- outcomePrices
["0.652", "0.348"]转换为“Yes:65.2%,No:34.8%” - 始终显示市场问题和概率
- 有交易量数据时一并提供
示例:"Will X happen?" — 65.2% Yes(交易量 $1.2M)
解析双重编码字段
Gamma API 在 JSON 响应中将 outcomePrices、outcomes 和 clobTokenIds 作为 JSON 字符串返回
(双重编码)。使用 Python 处理时,通过 json.loads(market['outcomePrices']) 解析以获取实际数组。
速率限制
限制宽松,正常使用不太可能触及:
- Gamma:每 10 秒 4,000 次请求(常规)
- CLOB:每 10 秒 9,000 次请求(常规)
- Data:每 10 秒 1,000 次请求(常规)
限制
- 此技能为只读,不支持下单交易
- 交易需要基于钱包的加密身份验证(EIP-712 签名)
- 某些新市场可能没有价格历史数据
- 交易受地理位置限制,但只读数据在全球范围内均可访问
评论
支持 Markdown