SuperAPI AI 工具集

polymarket

数据与分析

查看项目

更新于 10-16 07:23

技能介绍

用途:查询 Polymarket 预测市场数据,包括市场列表、当前价格、订单簿与价格历史,适合回答事件概率、赔率或跟踪市场走势。

主要能力:提供三个公开只读 API。Gamma API(gamma-api.polymarket.com)用于发现、搜索与浏览;CLOB API(clob.polymarket.com)用于实时价格、订单簿与历史;Data API(data-api.polymarket.com)用于成交与未平仓量。所有端点只读且无需认证。

关键概念:Event 包含一个或多个 Market;Market 为二元结果,Yes/No 价格在 0.00 至 1.00 之间,价格即概率,0.65 表示 65% 可能性。outcomePrices 为 JSON 编码数组,如 ["0.80","0.20"];clobTokenIds 为 [Yes, No] 两个代币 ID,用于价格与订单簿查询;conditionId 为十六进制字符串,用于价格历史查询;成交量以 USDC 计。

典型用法:先用 Gamma 的 public-search 端点搜索用户查询,解析事件及其嵌套市场,展示市场问题、价格百分比与成交量;如需深入,用 clobTokenIds 查订单簿,用 conditionId 查历史。展示时把 outcomePrices 转为百分比,如 ["0.652","0.348"] 显示为 Yes: 65.2%, No: 34.8%。注意 Gamma 返回的 outcomePrices、outcomes、clobTokenIds 为双重编码 JSON 字符串,Python 中需用 json.loads(market['outcomePrices']) 解析。

限制:本技能只读,不支持下单交易;交易需基于钱包的加密认证(EIP-712 签名)。部分新市场可能没有价格历史。交易受地域限制,但只读数据全球可访问。速率限制较宽松:Gamma 每 10 秒 4000 次,CLOB 每 10 秒 9000 次,Data 每 10 秒 1000 次。完整端点参考见 references/api-endpoints.md。