10分钟跑通Polymarket-Copy-Trading-Bot:新手快速上手安装与配置教程
10分钟跑通Polymarket-Copy-Trading-Bot:新手快速上手安装与配置教程
Polymarket-Copy-Trading-Bot 是一款自动跟单机器人:它会 24 小时监控你指定的 Polymarket 高手的交易动向,一旦发现新仓位,就在 1 秒内按你的资金比例自动计算仓位并下单,同时用 MongoDB 记录完整交易历史。本文是一份面向新手的完整安装与配置指南,跟着 5 个步骤操作,10 分钟内即可跑通第一个跟单机器人。
一、Polymarket 跟单机器人是怎么工作的?
在动手之前,先花 30 秒理解它的工作流程,后面配置会更有方向:
- 选择交易员 —— 从 Polymarket 排行榜挑选收益稳定的高手
- 监控动态 —— 机器人通过 Polymarket Data API 持续轮询其仓位变化(默认每 1 秒一次)
- 计算仓位 —— 按你的余额与目标交易员的比例自动缩放仓位大小
- 实时下单 —— 用你的钱包在 Polymarket 执行对应订单
- 记录业绩 —— 所有交易与仓位持久化到 MongoDB
核心逻辑位于 src/index.ts,交易执行由 src/services/tradeExecutor.ts 和 src/services/tradeMonitor.ts 完成。
二、开始前的准备清单
动手前请确认以下 6 项都就绪,缺哪项补哪项:
| 准备项 | 说明 | 备注 |
|---|---|---|
| Node.js v18+ | 运行环境 | 官方下载即可 |
| Polygon 钱包 | 执行交易的钱包 | 强烈建议新建专用钱包,别用主钱包 |
| USDC(Polygon 网络) | 交易本金 | 从交易所提币时网络务必选 Polygon |
| POL / MATIC | 燃气费 | 约 5-10 美元即可 |
| MongoDB 数据库 | 存储交易历史 | Atlas 免费档就够用 |
| Polygon RPC 端点 | 链上数据通道 | Infura / Alchemy 免费层均可 |
💡 钱包和资金怎么准备,docs/GETTING_STARTED.md 里有详细的图文步骤。
三、3 步完成安装(约 2 分钟)
打开终端,依次执行以下命令:
# 1. 克隆仓库并进入目录
git clone https://gitcode.com/gh_mirrors/ac/Polymarket-Copy-Trading-Bot
cd Polymarket-Copy-Trading-Bot
# 2. 安装依赖
npm install
# 3. 复制示例配置为正式配置
cp .env.example .env
示例配置文件 .env.example 已内置大量中文/英文注释,逐项填写即可。所有可用命令(构建、启动、检查、统计等)都定义在 package.json 的 scripts 中。
四、配置 .env:只需填对 5 组关键变量
打开刚生成的 .env,其余参数保持默认,重点填好下面几项:
| 变量 | 填什么 | 示例 |
|---|---|---|
USER_ADDRESSES |
要跟单的交易员地址(多个用逗号分隔) | '0x6a72..., 0x8c3d...' |
PROXY_WALLET |
你的 Polygon 钱包地址 | '0x1234...' |
PRIVATE_KEY |
钱包私钥(不带 0x 前缀) | 'abc123...' |
MONGO_URI |
MongoDB 连接字符串 | 'mongodb+srv://user:pwd@...' |
RPC_URL |
Polygon RPC 端点 | 'https://polygon-mainnet.infura.io/v3/...' |
而 CLOB_HTTP_URL、CLOB_WS_URL、USDC_CONTRACT_ADDRESS 三项保持默认值,不要改动。
⚠️ 重要提醒:PRIVATE_KEY 千万不要分享给任何人,也不要提交到代码仓库。程序在启动时会对所有必填变量做格式校验(见 src/config/env.ts),填错会直接报出缺了哪一项,按提示补齐即可。
如何挑选跟单的交易员?
去 Polymarket 排行榜,优先选择:总收益为正(绿数)、胜率高于 55%、最近 7 天有活跃交易、历史曲线稳定的地址;避开"只靠一笔大单爆赚"和长期不活跃的交易员。点击其主页后,URL 中的 0x... 就是地址,直接复制填入 USER_ADDRESSES。
五、构建、健康检查与启动机器人(约 3 分钟)
配置完成后,执行这三条命令:
npm run build # 编译 TypeScript
npm run health-check # 验证配置是否正确
npm start # 正式启动跟单机器人
npm run health-check 会逐项检查数据库连接、RPC 端点、钱包余额、Polymarket API 是否可用——全部通过后再启动。启动成功时,你会在终端看到类似下面的输出(MongoDB 已连接、CLOB 客户端就绪、进入等待交易状态):
看到 Waiting for trades from X trader(s)... 就说明机器人已在后台 24 小时盯盘,目标交易员一出手它会自动跟单。需要紧急停止时,按 Ctrl+C 即可优雅退出。
六、新手风控建议(务必阅读)
- 小资金起步:先用 500-1000 美元测试机器人行为,确认无误后再逐步加仓
- 分散跟单:同时跟 3-5 个不同风格的交易员,不把鸡蛋放在一个篮子里
- 每天查看日志:确认交易按预期执行,留意报错
- 认清风险:跟单不保本,历史业绩不代表未来收益,只投入可承受损失的资金
七、进阶功能与文档索引
跑通基础流程后,可以继续探索这些能力(均通过 .env 配置 + npm 脚本控制):
- 分级乘数:按交易规模应用不同跟单倍率,详见 docs/TIERED_MULTIPLIERS.md
- 多交易员配置:不同跟单策略说明见 docs/MULTI_TRADER_GUIDE.md
- 仓位追踪:机器人如何精准记录买卖,见 docs/POSITION_TRACKING.md
- 模拟回测:不花真钱验证策略盈利能力,见 docs/SIMULATION_GUIDE.md
- 常用脚本:查仓位、手动卖出、结算已决仓位等,入口在 src/scripts/,例如
npm run check-stats、npm run manual-sell
📖 完整新手教程:docs/GETTING_STARTED.md;老手 5 分钟速配:docs/QUICK_START.md
至此,你的 Polymarket 跟单机器人已经跑起来了。保持小步快跑、持续观察日志,让它先替你"抄作业"一段时间,再逐步调优跟单策略吧 🚀

