mcpField
P
polymarket

polymarket

github.com/nousresearch数据与数据库258.9k280 次安装今天更新
代码仓库

关于 polymarket

Polymarket — Prediction Market Data 通过 Polymarket 的公开 REST API 查询预测市场数据,适合查看事件概率、价格和交易活动。接口只读且无需身份验证,可进一步查询订单簿和价格历史。

主要功能

  1. 01搜索和浏览事件及市场
  2. 02查询市场价格与概率
  3. 03查看订单簿和价格历史
  4. 04查询交易与未平仓量
  5. 05公开 REST API 只读访问

适用场景

  1. 01比较事件结果的市场概率
  2. 02查看市场价格和成交量
  3. 03追踪预测市场价格变化
  4. 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

  1. Gamma API,位于 gamma-api.polymarket.com — 发现、搜索、浏览
  2. CLOB API,位于 clob.polymarket.com — 实时价格、订单簿、历史记录
  3. Data API,位于 data-api.polymarket.com — 交易、未平仓量

典型工作流

当用户询问预测市场赔率时:

  1. 搜索:使用 Gamma API 的 public-search 端点搜索用户的查询
  2. 解析:解析响应,提取事件及其嵌套市场
  3. 展示:提供市场问题、当前价格(以百分比表示)和交易量
  4. 深入查询:如用户需要,使用 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