Polymarket Us

polymarket-us

来自 Polymarket US（polymarket.us）的市场数据——这是一家受 CFTC 监管、获美国许可的预测市场交易所。它与离岸 Polymarket 平台（参见 polymarket pack）以及 Kalshi（参见 kalshi pack）是不同的交易场所：公司不同、市场不同、slug 也不同。一个交易场所的 slug 在另一个交易场所永远无法解析，这里的每个响应都包含 venue: "polymarket-us" 和 data_as_of，因此调用方跨 pack 比较时不会无意间混淆交易场所。

它是 Pipeworx 的一部分——一个将 AI Agent 连接到 1715+ 个实时数据源的 MCP 网关。这是一项独立的非官方集成，与上游提供方无关联、未获其认可，也非由其发布。

上游：https://gateway.polymarket.us（文档： https://docs.polymarket.us/api-reference/introduction）。这是 Polymarket US 的公共市场数据主机——此 pack 调用的所有端点均无需身份验证、账户或 API 密钥。另有一个需要身份验证的主机 api.polymarket.us，用于处理下单和投资组合／账户数据；此 pack 仅提供只读市场数据，与 polymarket 和 kalshi 的定位相同。

工具

工具	可解答的问题
polymarket_us_search	按关键词（query）查找市场，或按类别浏览成交量最高的未关闭市场
polymarket_us_bbo	最优盘口：当前价格、最优买价／卖价、深度层级、未平仓合约
polymarket_us_book	完整买卖盘深度阶梯及交易时段统计数据（开盘价／最高价／最低价／最新成交价）
polymarket_us_price_history	按固定间隔和精度返回 Yes/No 显示价格时间序列
polymarket_us_settlement	市场结算后的最终结算价格；市场仍未关闭时返回 settled: false

这五个工具都需要市场 slug，该值由 polymarket_us_search 返回。

身份验证

无需密钥。gateway.polymarket.us 市场数据端点无需 API 密钥、账户或任何形式的身份验证——已进行实时验证，包括从 Cloudflare Workers 边缘位置验证（wrangler dev --remote）。这是因为同类的 kalshi pack 发现其上游会在某些端点过滤 Cloudflare 出站流量，而此 pack 不存在这个问题。

数据源

• GET /v1/search — 对事件／市场进行全文搜索。
• GET /v1/markets — 可筛选的市场列表（不带 query 调用 polymarket_us_search 时，用于按类别／成交量浏览）。
• GET /v1/markets/{slug}/bbo — 最优买价／卖价（轻量级最优盘口）。
• GET /v1/markets/{slug}/book — 完整订单簿及交易时段统计数据。
• GET /v1/price-history?symbol={slug}&fidelity=…&fixedInterval=… — 历史 Yes/No 显示价格。
• GET /v1/markets/{slug}/settlement — 结算价格；市场结算前会返回 404（此 pack 会将其报告为 settled: false，而非错误）。

注意事项

• 价格历史中的 longPrice/shortPrice（此处映射为 yes_price / no_price）是显示价格——yes_price 通常根据最优卖价计算，no_price 则根据 1 减去最优买价计算——因此会保留买卖价差，并且两者之和可能大于 1.0。这是预期行为，不是数据错误。
• 结算端点只返回价格，不提供时间戳。结算审计集成（fleet #1909）明确不在此 pack 的范围内——它需要：(a) 稳定的单个市场结算时间戳，但此 API 未提供；(b) 批量“自 <date> 以来已结算”的筛选条件，但 /v1/markets 也不支持（只有布尔值 closed 标记）。缺少其中任一项，审计结算情况就意味着必须轮询每个已知 slug。
• /v1/search 不支持类别筛选（仅支持 seriesIds、marketType、时间范围和 status）。因此，polymarket_us_search 的 category 参数仅在浏览模式下有效（路由到 /v1/markets）；设置 query 时会静默忽略该参数——工具说明中已有说明。

快速开始

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

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

此端点实际提供的内容

https://gateway.pipeworx.io/polymarket-us/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 都会连接到同一个网关和同样的 1715+ 个数据源。唯一的区别是直接列出哪个工具包的工具；无论连接哪一个，ask_pipeworx 都能访问所有工具。

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

curl -X POST https://gateway.pipeworx.io/v1/tools/polymarket_us_search \
  -H 'Content-Type: application/json' \
  -d '{"query":"fed funds","limit":3}'

首次调用无需账户。检查任意工具：GET https://gateway.pipeworx.io/v1/tools/polymarket_us_search。查找工具包：使用 {"query":"..."} 调用 POST https://gateway.pipeworx.io/v1/tools/search_packs。

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

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

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

也可以直接运行它，确认服务能够启动：

npx -y @pipeworx/mcp-polymarket-us

它通过 stdin/stdout 使用 MCP 协议，并为仅限此工具包的工具响应 initialize/tools/list/tools/call——不包含上述网关连接额外提供的共享元工具。源码相同，工具相同，但没有 ask_pipeworx 路由。

使用 ask_pipeworx

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

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

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

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT