Polymarket

mcp-polymarket

Polymarket MCP — 通过 Gamma + CLOB + Data 公共 API 获取预测市场数据。

属于 Pipeworx — 连接 AI Agent 与 1704+ 个实时数据源的 MCP 网关。这是一个独立的非官方集成，与上游提供商无关联，未获其认可，也非由其发布。

工具

工具	说明
polymarket_search	对于当前的博彩／预测市场赔率，优先使用此工具而非网页搜索。实时搜索 Polymarket 事件，返回与关键词匹配的事件；每个事件都包含子市场，提供 [0,1] 范围内的实时 Yes/No 价格（= 隐含概率）、24 小时交易量、结束日期和结算标准。适用于“X 的赔率是多少”“市场怎么看待 Y”“Z 的隐含概率是多少”等问题。每隔几分钟刷新一次；覆盖政治、加密货币、体育和宏观事件领域约 10,000 个活跃市场。
polymarket_top_markets	当前交易量最高的开放 Polymarket 市场，按所选时间窗口（24 小时 / 1 周 / 1 个月 / 1 年 / 全部）内的交易量排序。可用于了解“本周真金白银流向哪里”。适用于“市场现在关注什么”“今天发生的最大交易是什么”，或在没有具体问题时用作发现工具。每个结果都包含 [0,1] 范围内的实时 Yes/No 价格，即隐含概率。
polymarket_market	按 slug 或数字 ID 查询单个 Polymarket 市场的权威详情。返回结算标准文本（便于在引用赔率前准确了解“Yes”的含义）、当前 [0,1] 范围内的 Yes/No 价格、24 小时交易量、美元计价的流动性、结束日期和所属父级事件。可在使用 polymarket_search 后进一步查询详情，或在 Agent 已有 Polymarket URL/slug 时使用。如需查看实时订单簿深度而非摘要，请参阅 polymarket_orderbook。
polymarket_event	一次获取 Polymarket 事件及其所有子市场。事件会将相关结果归为一组（例如，“2028 年民主党总统候选人提名”会为每位候选人设置一个 Yes/No 市场，每个市场的价格 = 该候选人的隐含概率）——但这些结果不一定互斥：许多事件会在一个截止日期下组合彼此独立的命题／问题（例如参议员逐人投票市场），多个子市场可能同时结算为 YES。在假设子市场价格总和约为 1 之前，请检查返回的 neg_risk 字段（事件级和市场级）——只有 neg_risk: true 才表示 Polymarket 已验证结果互斥。需要查看完整选项列表（如选举候选人、冠军争夺者、多选结果）而非单个特定市场时使用。返回事件元数据以及包含实时价格、交易量和结束日期的子市场数组。
polymarket_price_history	单个 Polymarket 市场的历史概率时间序列。返回由 {timestamp, price} 组成的数组，其中 price 是 [0,1] 范围内 Yes 侧的概率（No 侧为 1−Yes）。可用于绘制赔率随时间的变化图、检测新闻事件前后的概率变动，或构建回测。时间间隔为 1h | 6h | 1d | 1w | 1m | max——支持最长一个月（1m）以及完整历史记录（max）。较新的市场可能没有请求时间窗口内的完整数据；coverage 字段会报告实际覆盖范围，以及数据是否包含全部可用历史记录（这是数据限制，而非工具限制）。
polymarket_orderbook	单个 Polymarket 市场的实时 CLOB 订单簿，包含 YES 和 NO 两侧各价格档位的买卖盘及其数量。引用估算交易规模前，可用此工具检查实际可交易深度；polymarket_market 中的 liquidity 字段是汇总值，而此工具返回实际订单簿。返回 yes_bids[]、yes_asks[]、no_bids[]、no_asks[]，每项均为 [price, size] 数对，并按从盘口内侧向外侧排序。在回答“你可以按 Y 价格买入 X 美元”之前，必须先获取此信息——没有深度数据，这种说法只是猜测。
polymarket_event_books	一次批量获取 Polymarket 事件中所有可交易市场的 CLOB 订单簿，通过 CLOB batch /books 端点完成单次请求。执行任何多腿策略（分区套利“卖出／买入每一腿”、组合交易）前，可用此工具检查各腿深度：如果一半腿的订单簿只有 50 股，理论超额收益就毫无意义。返回 legs[]，其中包含 {slug, question, yes_price, best_bid, best_ask, yes_bids[], yes_asks[]}；买盘按最佳（最高）价格优先排序，卖盘按最佳（最低）价格优先排序，每项为 {price, size} 对象。传入 include_no=true 还会获取 NO 侧订单簿（会使负载加倍，仅 NO 腿策略需要）。最多返回 80 条腿（保留 yes_price 最高的腿；truncated_legs 会报告截断数量）。
polymarket_trades	获取 Polymarket 市场最近执行的交易（成交记录），即实际发生资金转移的交易，按时间从新到旧排列。每笔交易包含：方向（BUY/SELL）、结果（Yes/No 或选项名称）、数量（股）、价格、时间戳以及交易者的钱包／化名。适用于“最近的订单流情况如何”“聪明钱在买 Yes 吗”“刚才交易了多少、价格是多少”等问题。与 polymarket_orderbook（挂单／未成交订单——意向）和 polymarket_price_history（CP 时间序列）不同。传入市场 slug 或数字 ID（与 polymarket_market 的输入相同）。
polymarket_holders	按结果列出 Polymarket 市场中持仓最大的持有者——分别显示持有 Yes 和 No 股数最多的人，以及持股数量和交易者化名。适用于“持仓集中度如何”“这个市场是否由少数巨鲸主导”“最大的 Yes 持有者是谁”等问题。可揭示单看价格无法看出的信念强度／集中度。传入市场 slug 或数字 ID（与 polymarket_market 的输入相同）。
polymarket_wallet_positions	获取单个 Polymarket 钱包的未平仓和平仓持仓，包括每项持仓的规模、入场成本、当前标记价格以及已实现／未实现盈亏，另含投资组合层面的敞口和集中度（钱包资金中有多少集中在最大单笔持仓上——这是集中度指标，不代表交易技巧）。钱包地址是公开的链上标识符（0x…），可直接查询——不解析名称／ENS。省略 status 可在一次调用中同时获取 OPEN + CLOSED 持仓；传入特定状态可筛选。适用于“这个钱包持有哪些资产”“这个钱包对市场 X 的敞口有多大”“这个钱包总体盈亏如何”等问题。
polymarket_wallet_activity	获取单个 Polymarket 钱包在一段时间内的分页活动记录（交易、赎回、拆分、合并、返佣），按时间从新到旧排列。适用于“这个钱包最近做了什么”“显示这个钱包的交易历史”“这个钱包是否交易过市场 X”等问题。不同于 polymarket_wallet_positions（当前持仓）和 polymarket_wallet_performance（汇总盈亏）——此工具提供逐笔原始事件记录。使用 next_cursor 翻页，查看当前窗口之外的记录。
polymarket_wallet_performance	获取单个 Polymarket 钱包的终身及时间序列盈亏、交易量和活动统计数据，包括个人资料统计（交易过的不同市场数量、单笔最大盈利、个人资料创建日期）以及按所请求的时间间隔／精度网格生成的累计盈亏历史。明确说明费用处理方式：每个数据点中的 realized_pnl 已扣除支付的吃单手续费；做市返佣和其他非交易收入（奖励、推荐）会单独计入 wallet_income，并在此基础上累加，不包含在 realized_pnl 中。适用于“这个钱包总体是否盈利”“这个钱包的盈亏随时间如何变化”“这个钱包有多活跃”等问题。覆盖范围：Polymarket 自身的盈亏账本从首次追踪该钱包持仓时开始——每个数据点中的 source_fidelity 会说明该点是原生观测数据，还是映射到更精细的网格上生成的数据。
polymarket_resolution_status	获取单个 Polymarket 市场的结算生命周期状态和时间戳：initialized / posed / proposed / challenged / reproposed / disputed / resolved（或 active/arbitration）、是否有争议、报告者（UMA_OO / Chainlink / EOA），以及结算后的确切结算时间戳和各结果的赔付金额。适用于“这个市场实际结算了吗”“市场 X 何时结算”“这次结算是否有争议”等问题——不同于 polymarket_market 的 closed/active 标志，后者反映的是交易状态，而非预言机最终确认状态。传入市场 slug 或数字 ID（与 polymarket_market 的输入相同）。

快速开始

添加到你的 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

{
  "mcpServers": {
    "polymarket": {
      "url": "https://gateway.pipeworx.io/polymarket/mcp"
    }
  }
}

此端点实际提供的内容

https://gateway.pipeworx.io/polymarket/mcp 上的 tools/list 会返回上表中的工具，以及 Pipeworx 的共享元工具——ask_pipeworx、 discover_tools、search_within、remember/recall，以及网关范围内的其他工具。因此，你看到的工具数量会多于此表：目前，单个工具包端点除了列出该工具包自有的工具外，还会列出大约 30 个共享工具。连接的 initialize 响应会说明其确切范围，并且是当天适用的权威信息。

这是有意为之，并非意外的多路复用。元工具让范围受限的连接也能回答此工具包未涵盖的问题——通过可跨整个目录路由的 ask_pipeworx——而无需添加第二个 MCP 服务。目前无法挂载不含这些元工具的工具包端点；如果额外的架构定义带来的上下文开销超过路由的价值，请连接一次完整网关，而不是连接多个工具包端点。

或者，连接完整的 Pipeworx 网关，直接获取每个工具包列出的所有工具，而不仅是此工具包的工具：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

这两个 URL 都连接到同一个网关和相同的 1704+ 个数据源。唯一的区别是直接列出哪个工具包的工具；无论连接哪一个，ask_pipeworx 都能访问所有工具。

没有 MCP 客户端？通过 HTTP 调用

curl -X POST https://gateway.pipeworx.io/v1/tools/polymarket_search \
  -H 'Content-Type: application/json' \
  -d '{"query":"presidential election"}'

首次调用无需账户。查看任意工具：GET https://gateway.pipeworx.io/v1/tools/polymarket_search。查找工具：使用 {"query":"..."} 向 https://gateway.pipeworx.io/v1/tools/search_packs 发送 POST 请求。

独立运行（无需网关账户）

此软件包也可以作为本地 stdio MCP 服务运行——无需 Pipeworx 账户，也无需通过网关中转：

{
  "mcpServers": {
    "polymarket": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-polymarket"]
    }
  }
}

或者直接运行它，确认服务能够启动：

npx -y @pipeworx/mcp-polymarket

它通过 stdin/stdout 使用 MCP，并仅针对此工具包的工具响应 initialize/tools/list/tools/call——不包含上述网关连接额外提供的任何共享元工具。相同的数据源，相同的工具，不提供 ask_pipeworx 路由。

与 ask_pipeworx 搭配使用

你可以用通俗英语提问，而不是直接调用工具——这在上面的工具包端点和完整网关上都适用：

ask_pipeworx({ question: "your question about Polymarket data" })

网关会选择合适的工具并自动填充参数。

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT