接入 AI agent

通过 MCP、命令行或 OpenAPI 接入 Claude、ChatGPT 等 agent。

AI agent 可以查询交易者、订阅成交并处理数据。下面列出几种接入方式。

你的 agent	接入方式	需要
claude.ai、ChatGPT	远程 MCP	PMWallets 账户,通过 OAuth 登录
Claude Code、Cursor、Claude Desktop	远程或本地 MCP	远程用 OAuth 或客户端支持的 Bearer 认证;本地用 API key + Node.js
Codex、Gemini CLI、WorkBuddy、脚本	命令行,或客户端支持的本地 MCP	API key;Node.js(MCP/命令行)或 Python(命令行)
Dify、Coze、n8n、GPT Actions	OpenAPI 和 webhook	API key

远程 MCP

不用安装。把这个地址添加为自定义连接器或远程 MCP server:

url

https://api.pmwallets.com/mcp

使用 OAuth 时,在 pmwallets.com 登录并授权,客户端便可获取和刷新仅用于 MCP 的 token。连接显示在 API keys 页,名称为「<应用> (OAuth)」,删除即可断开。支持 Bearer 认证的客户端(如 Claude Code、Cursor)和脚本也可以直接发送已有的 key:Authorization: Bearer pmw_…。

不注册也可以连 https://api.pmwallets.com/mcp/public:提供 leaderboard、entity、market 三个工具,可查固定的 20 个榜单样本、这些交易者的战绩,以及市场信息。

本地 MCP

把下面的配置加到客户端的 MCP 设置里,key 在 API keys 页面创建。第二个 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"]
    }
  }
}

命令行

数据查询命令输出 JSON。Python 版用 uvx pmwallets 运行,替换示例中的 npx pmwallets。把 npx pmwallets skill 输出的说明交给 agent。

shell

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 可能已经下过单。

shell

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:*)"'

定时查询可用本地 MCP 的 new_fills,游标保存在本机文件中。每个调用方应单独设置 PMW_MCP_STATE,CLI 默认共用同一个文件。远程 MCP 用 fills,下次调用时把返回的 next 传入 sinceBlock/sinceLogIndex。

没有命令行的平台

导入 openapi.json 后,可以用 HTTPS 调用同样的接口;用 webhook 接收每笔成交的推送。

工具一览

工具	用途
`leaderboard, entity, market`	查询榜单、交易者战绩,以及 token 对应的市场和结果选项。
`subscribe, cancel_subscription, subscriptions`	订阅已解锁地址的交易者,取消订阅,查看订阅列表。
`new_fills, fills`	new_fills 仅本地 MCP,自动保存游标;fills 两端都有,按账本位置回放。
`signals, radar`	多个聪明钱钱包买入同一方向、大额吃单成交。本地及登录后的远程 MCP 都支持,需要 Pro 或 Max。
`export_options, export_quote, buy_export, exports, export_files, export_file`	查询可售日期和价格,购买历史成交并读取文件。仅远程 MCP。
`account`	你的套餐和余额。

下单

PMWallets 不下单,也接触不到私钥。开源跟单机器人在你的机器上,用你的 Polymarket 账户下单。

买单是全部成交否则取消(fill-or-kill),USDC 金额是上限。
把成交的 eventId 作为 key 传入:同一个 key 不会下第二单,重试不会重复下单。
dry-run 模式按实时盘口模拟订单。检查结果后再切到 live。

agent 能花多少钱

API key 可以花账户余额,没有单独的消费上限。订阅前要先解锁地址,之后推送运行期间每小时 $0.01,或占用套餐名额。导出可用余额购买,也可用付费套餐额度。给 agent 用的账户里只放你愿意让它花的钱。创建其他 key 和修改套餐需要在浏览器登录,API key 无权操作。

另见:agent 能用 PMWallets 做什么、SDK 接入说明。

← 错误码 SDK、机器人与插件 →