跳到主要內容

Polymarket

查詢 Polymarket 預測市場數據 — 搜索市場、獲取價格、訂單簿和價格歷史。通過公共 REST API 進行只讀訪問，無需 API 密鑰。

技能元數據​

來源捆綁（默認安裝）
路徑skills/research/polymarket
版本1.0.0
作者Hermes Agent + Teknium

參考：完整 SKILL.md​

信息

以下是 Hermes 在觸發此技能時加載的完整技能定義。這是技能激活時代理看到的指令。

Polymarket — 預測市場數據

使用 Polymarket 的公共 REST API 查詢預測市場數據。 所有端點均為只讀，且無需任何身份驗證。

有關包含 curl 示例的完整端點參考，請參閱 references/api-endpoints.md。

何時使用​

  • 用戶詢問有關預測市場、投注賠率或事件概率的問題
  • 用戶想知道“X 發生的幾率是多少？”
  • 用戶特別詢問關於 Polymarket 的信息
  • 用戶想要市場價格、訂單簿數據或價格歷史
  • 用戶要求監控或跟蹤預測市場動態

關鍵概念​

  • 事件 (Events) 包含一個或多個 市場 (Markets)（1:多關係）
  • 市場 是具有二元結果的市場，Yes/No 價格在 0.00 到 1.00 之間
  • 價格即概率：價格 0.65 意味著市場認為有 65% 的可能性
  • outcomePrices 字段：JSON 編碼的數組，如 ["0.80", "0.20"]
  • clobTokenIds 字段：用於價格/訂單簿查詢的兩個代幣 ID [Yes, No] 的 JSON 編碼數組
  • 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 volume)

解析雙重編碼字段​

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 簽名）
  • 某些新市場可能沒有價格歷史
  • 交易存在地理限制，但只讀數據全球可訪問