SuperAPI AI 工具集

polymarket

数据与分析

查看项目

更新于 10-16 07:15

技能介绍

用途:查询 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 API 的 public-search 端点;解析响应中的 events 及其嵌套 markets;展示市场问题、以百分比表示价格及成交量;需要时用 clobTokenIds 查订单簿、conditionId 查历史。展示时把 outcomePrices ["0.652","0.348"] 转成 “Yes: 65.2%, No: 34.8%”。注意 Gamma API 的 outcomePrices、outcomes、clobTokenIds 是双重编码的 JSON 字符串,Python 中需用 json.loads(market['outcomePrices']) 解析。

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