PMWallets
EN

给 AI agent 用的 Polymarket 数据:MCP server 与命令行

Claude、Cursor、Codex、Gemini CLI、WorkBuddy 等 AI agent 可以查看 Polymarket 交易者排行榜,选择要关注的人,并实时处理他们的成交。两个工具都开源,输出 JSON。

agent 能做什么

  • leaderboard:按 30 天或 7 天给交易者排名,可按类别、胜率(区间下限)、风格、规模筛选。
  • entity:查看单个交易者的完整战绩,包括盈亏、盈利和亏损的市场数、挂单或吃单情况,以及主要交易类别。免费账户可查看固定的 20 个样本和自己付费解锁过的交易者;有有效月度套餐时,可以查看榜单上的其他交易者。
  • subscribe / cancel_subscription / subscriptions:订阅已解锁地址的交易者的成交,取消订阅,或查看当前订阅列表。
  • new_fills:返回上次调用后的成交,每笔只返回一次,适合由 agent 定时调用。
  • fills 与 market:按账本位置回放成交;根据 token ID 查询市场问题和结果选项。
  • account:你的套餐与余额。

作为 MCP server 接入

把下面这段加到 Claude Desktop、Claude Code、Cursor 或其他支持本地 MCP server 的客户端设置里。API key 在账户页生成。第二个 server 是可选的跟单机器人,只有要让 agent 下单时才需要。

json
{
  "mcpServers": {
    "pmwallets": {
      "command": "npx",
      "args": ["-y", "pmwallets", "mcp"],
      "env": { "PMW_API_KEY": "pmw_..." }
    },
    "copytrade": {
      "command": "npx",
      "args": ["-y", "pmwallets-copytrade", "mcp", "--config", "/abs/path/config.yaml"]
    }
  }
}

或者直接用命令行

Node.js 包和 Python 包都提供 `pmwallets` 命令,可调用同样的功能;Python 版可以用 `uvx pmwallets` 运行。每条命令都输出 JSON,agent 可以通过 shell 调用并读取结果;`npx pmwallets skill` 会输出供 agent 使用的操作说明。

bash
export PMW_API_KEY=pmw_...
npx pmwallets leaderboard --category politics --minWinLo 0.55 --limit 20
npx pmwallets entity <handle>
npx pmwallets subscribe <handle>      # billed per hour while it runs
npx pmwallets new-fills               # fills since the previous call, each once
npx pmwallets watch                   # live: one JSON line per fill

成交一出来就处理

`watch --exec` 每来一批成交就运行一次你指定的命令,成交从标准输入传进去。每批最多执行一次。命令失败或超时后,该批成交会保存在 pmw-watch/failed/,不会自动重跑,因为 agent 可能已经下过单。重启后从断开的地方接着推。

bash
npx pmwallets watch --batch-sec 30 --exec 'claude -p "Fills from traders I follow are on stdin. For each BUY above $1000, check the market with pmwallets-copytrade market, and buy $5 with --key <eventId> if the price is below 0.6." --allowedTools "Bash(pmwallets-copytrade:*)"'

下单

PMWallets 从不下单,也接触不到私钥。开源机器人 pmwallets-copytrade 在本机使用你的 Polymarket 账户下单,供 agent 调用的工具包括 market、balance、positions、trades、order_buy 和 order_sell。

  • 买单是全部成交否则取消(fill-or-kill),USDC 金额是上限,不会超出。
  • 把成交的 eventId 作为 key 传进去:同一个 key 不会下第二单,agent 重试也不会重复下单。
  • dry-run 模式按实时盘口模拟每笔订单;检查 agent 的交易决策,确认符合预期后再切到实盘。
  • 私钥保留在本机,可通过配置或环境变量提供;机器人输出中的密钥会被打码。

没有 shell 的平台

Dify、扣子(Coze)、n8n、GPT Actions 可以导入 https://pmwallets.com/openapi.json 这份 OpenAPI 描述,通过 HTTPS 调同样的接口。也可以用带签名的 Webhook,每笔成交主动推到你指定的地址。

API key 能花多少钱

API key 可以花账户余额。关注一个交易者之前要先解锁他的地址(一次性,价格在榜单上标出,部分免费,也可以用月度套餐的额度),之后推送运行期间每小时 $0.01,或占用套餐的一个名额;导出也要付费。key 没有单独的花费上限,所以给 agent 用的账户里只放你愿意让它花的钱。创建其他 key 和修改套餐都需要在浏览器中登录账户,API key 无权操作。

常见问题

有 Polymarket 的 MCP server 吗?

有。运行 `npx -y pmwallets mcp`,agent 就能查询 Polymarket 交易者排行榜、交易者战绩,以及你关注的交易者的实时成交。`pmwallets-copytrade mcp` 还可以查询行情,并使用你自己的账户下单。

ChatGPT 能用吗?

可以通过 GPT Actions:导入 https://pmwallets.com/openapi.json,用你的 API key 认证。能在本地跑命令或 MCP server 的 agent(Claude、Cursor、Codex、Gemini CLI、WorkBuddy)可以直接用 MCP server 或命令行。

PMWallets 会替我交易吗?

不会。PMWallets 只卖数据。开源跟单机器人在你的机器上下单,每笔买单有你设置的 USDC 上限;用成交的 eventId 作为 key 时,重试不会重复下单。默认使用 dry-run,手动切换后才会实盘交易。

要花多少钱?

注册账户后即可免费查询交易者排行榜。要关注某个交易者,先一次性解锁他的地址(部分免费),之后他的实时成交每小时 $0.01,或用月度套餐。MCP server、命令行和跟单机器人都免费,MIT 协议开源。

相关页面