Polymarket Copy Trading Bot 跟单机器人10分钟快速上手:新手完整安装与配置教程
Polymarket Copy Trading Bot 跟单机器人10分钟快速上手:新手完整安装与配置教程
Polymarket Copy Trading Bot 是一款面向 Polymarket 预测市场的自动跟单机器人(copy trading bot):它 7×24 小时监控你选定的顶级交易者,按你的资金比例自动复制下单,并把完整交易历史记录到 MongoDB。本教程专为新手编写,带你用 10 分钟完成安装、配置与健康检查,快速跑起第一个跟单任务。
🤖 什么是 Polymarket 跟单机器人?
一句话理解:你跟着高手买,机器人自动帮你执行。
整个跟单流程分为 5 步,全部自动化完成:
- 选择交易者 — 指定你要跟的钱包地址
- 监控动态 — 通过 Polymarket Data API 每秒检查一次目标交易者是否开了新仓
- 计算仓位 — 按「你的余额 / 交易者余额」自动换算成你的下注金额
- 执行订单 — 用你的钱包实时提交 Polymarket 订单
- 追踪表现 — 所有买卖记录持久化到 MongoDB,方便复盘
核心特性包括:多交易者同时跟单、智能仓位缩放、分级倍率(Tiered Multipliers)、小额订单聚合、滑点保护等,配置逻辑位于 src/config/env.ts 与 src/config/copyStrategy.ts。
📋 安装前准备:5 分钟备齐 4 样东西
开始之前,请对照清单确认以下依赖已就绪:
| 依赖项 | 版本/要求 | 用途 |
|---|---|---|
| Node.js | v18+ | 运行机器人 |
| MongoDB | Atlas 免费层即可 | 存储交易记录 |
| Polygon 钱包 | MetaMask 等 Web3 钱包 | 执行真实交易 |
| RPC 端点 | Infura / Alchemy 免费层 | 连接 Polygon 主网 |
⚠️ 建议单独建一个专用钱包给机器人使用,并充值:
- USDC:交易本金(Polymarket 用 USDC 结算)
- POL(原 MATIC):约 $5–10,用于支付 Gas 费
资金充值细节可参考 docs/FUNDING_GUIDE.md。
🚀 10分钟快速安装步骤
第一步:克隆仓库并安装依赖
git clone https://gitcode.com/gh_mirrors/minimalist4/polymarket-copytrading-bot
cd polymarket-copytrading-bot
npm install
执行 npm install 后会自动触发 postinstall 脚本,进入交互式配置向导(对应 src/scripts/postinstall.js)。
第二步:复制配置模板
cp .env.example .env
第三步:构建项目
npm run build
构建脚本与所有 npm 命令定义见 package.json。
⚙️ 最快配置方法:.env 核心环境变量详解
打开 .env 文件,填入以下 5 个必填变量即可(启动时会自动校验,缺失会直接提示,校验逻辑见 src/config/env.ts):
| 变量 | 说明 | 示例 |
|---|---|---|
USER_ADDRESSES |
要跟单的交易者地址,多个用逗号分隔 | '0xabc..., 0xdef...' |
PROXY_WALLET |
你的 Polygon 钱包地址 | '0x123...' |
PRIVATE_KEY |
钱包私钥(不带 0x 前缀) | 'abc123...' |
MONGO_URI |
MongoDB 连接串 | 'mongodb+srv://...' |
RPC_URL |
Polygon RPC 地址 | 'https://polygon-mainnet.infura.io/v3/xxx' |
另外 3 个变量保持默认即可,不要修改:CLOB_HTTP_URL、CLOB_WS_URL、USDC_CONTRACT_ADDRESS。
可选的风控参数,新手建议先配好前两个:
| 变量 | 默认值 | 作用 |
|---|---|---|
TRADE_MULTIPLIER |
1.0 | 跟单倍率,2.0 即双倍激进 |
MAX_ORDER_SIZE_USD |
100.0 | 单笔订单上限,防止一次下太多 |
FETCH_INTERVAL |
1 | 检查交易者的间隔(秒) |
完整配置说明见 docs/QUICK_START.md,进阶策略(如分级倍率)见 docs/TIERED_MULTIPLIERS.md。
✅ 运行健康检查:一键验证配置
启动前先做体检,确认钱包、数据库、RPC、Polymarket API 全部通畅:
npm run health-check
该命令由 src/scripts/healthCheck.ts 实现,所有项显示 ✅ 后即可放心启动。成功后运行 npm start,终端会显示类似下面的界面:
看到 Waiting for trades from 1 trader(s)... 即表示机器人已上线,开始 7×24 小时盯盘。
🎯 如何挑选值得跟单的 Polymarket 交易者
跟单效果一半取决于代码,一半取决于跟谁。挑选标准:
✅ 优选特征
- 总收益为正(绿色数字)
- 胜率高于 55%
- 近 7 天仍有活跃交易
- 历史战绩稳定,不是一夜暴富型
❌ 避开信号
- 只赢过一大注、其余无交易
- 胜率低于 50%
- 数周不活跃
- 仓位大到你无法按比例复制
推荐同时跟 3–5 个风格不同的交易者分散风险,详细方法论见 docs/TRADER_SELECTION_GUIDE.md 与 docs/MULTI_TRADER_GUIDE.md。
⚠️ 新手安全建议与常见问题排查
安全铁律
- 小额试跑:先用 $500–1000 验证机器人行为正确,再逐步加码
- 每日查看日志,确认每笔跟单符合预期
- 无内置止损,可能亏光本金——只投入可承受损失的资金
- 紧急停止:终端按
Ctrl+C,机器人会优雅关闭并断开所有连接
常见问题速查
| 现象 | 解决方法 |
|---|---|
提示 USER_ADDRESSES is not defined |
重新运行 npm run setup 或手动补全 .env |
MongoDB connection failed |
检查 MONGO_URI 与 Atlas 的 IP 白名单(测试可放开 0.0.0.0/0) |
| 检测不到任何交易 | 确认目标交易者近期确实有交易,地址抄写无误 |
提示 Insufficient balance |
补充 USDC 本金与 POL Gas 费 |
📚 延伸阅读与项目资料
- 新手完整指南:docs/GETTING_STARTED.md
- 快速上手参考:docs/QUICK_START.md
- 部署指南:docs/DEPLOYMENT.md
- 仓位追踪原理:docs/POSITION_TRACKING.md
- 回测模拟:docs/SIMULATION_GUIDE.md
- 核心源码:src/index.ts(主入口)、src/services/tradeMonitor.ts(监控)、src/services/tradeExecutor.ts(执行)
免责声明:本项目仅供教育用途,交易存在亏损风险,过往收益不代表未来表现,请仅投入可承受损失的资金。

