gulelmatthews/Polymarket-Perpetual-Bot · 上手攻略

仓库：gulelmatthews/Polymarket-Perpetual-Bot
链接：https://github.com/gulelmatthews/Polymarket-Perpetual-Bot
分类：multimodal · trading · agent
作者：Tom
更新：2026-09-28

一、是什么

Polymarket-Perpetual-Bot 是一个面向 Polymarket 预测市场的终端交易机器人，基于 Polymarket 的 Polygon CLOB（Central Limit Order Book）API 构建。它以键盘驱动的 TUI（终端用户界面）呈现，集成了行情浏览、实时订单簿查看、策略引擎和持仓追踪四大模块，支持模拟交易（paper trading）和实盘交易两种模式。

Polymarket 是一个基于 Polygon 链、以 USDC 结算的预测市场平台，市场报价本质上是对事件发生概率的定价。Bot 通过比较市价与「公平概率模型」的差异来寻找边缘（edge），并支持流动性提供与跨市场套利策略的信号生成。

⚠️ 默认运行在模拟交易模式，需要显式配置才能进入实盘。

二、解决什么问题

预测市场交易有几个独特的操作难点：

实时 CLOB 订单簿难以快速目视——需要同时看多个 YES/NO 档位、买卖价差、订单簿失衡
手工计算概率边缘（probability edge）效率低——需要对比市场定价与主观概率模型
策略执行与持仓追踪分散——信号、订单、PnL 分散在不同工具里
实盘风险高、监管复杂——美国等地区对 Polymarket 有准入限制，且预测市场本身有价格波动风险

这个 Bot 把以上四件事集成到一个终端界面里，用 Textual/Rich 构建，用键盘快捷键操作，适合在 Linux/macOS/Windows 上运行。

三、快速安装

环境要求

Python 3.10+
pip 或 conda
支持 WebSocket 的网络环境（访问 Polygon RPC 和 Polymarket CLOB API）

安装步骤

# 克隆仓库
git clone https://github.com/gulelmatthews/Polymarket-Perpetual-Bot.git
cd Polymarket-Perpetual-Bot

# 安装依赖
pip install -r requirements.txt

# 首次运行（默认模拟模式，不需要任何密钥）
python main.py --demo

一键启动脚本（无需配置系统 Python）：

# Linux / macOS
chmod +x run.sh && ./run.sh

# Windows
run.bat

配置实盘（可选）

在 ~/.polymarket-bot/config.toml（需 chmod 0600）写入：

[auth]
private_key = "0x…"          # Polygon EOA 私钥
proxy_address = "0x…"        # Polymarket 代理/签名地址
api_key = "…"
api_secret = "…"
api_passphrase = "…"
endpoint = "https://clob.polymarket.com"

⚠️ 永远不要把 config.toml 提交到版本库，私钥必须保持离线存储并限制文件权限。

四、核心用法

界面导航

快捷键	功能
`1`–`6`	切换 Dash / Markets / Book / Strategy / Positions / Log
`/`	过滤市场列表
`Enter` / `b`	打开选中市场的 CLOB 订单簿
`s`	对整个观察列表运行策略引擎
`o`	发出模拟订单（paper order）
`t`	切换主题
`q`	退出（服务器端 agents 继续运行）

策略引擎

Bot 内置三种可组合策略：

Probability-Edge（概率边缘）
将市场报价与内置公平概率模型对比，超过阈值时发出信号（confidence 0..1 + 建议方向 YES/NO）
Book-Imbalance（订单簿失衡）
检测 YES/NO 双方体量差异作为方向信号
Liquidity（流动性套利）
买卖价差（spread）异常宽时，信号均值回归策略

# 在 TUI 内按 s 触发策略扫描
# 信号会显示 conf（置信度 0~1）和建议方向

模拟交易模式

# 默认 paper 模式，带虚拟 12,000 USDC 余额
python main.py --demo

# 观察 Signals 队列，Paper P&L 自动计算

五、典型适用场景

场景	为什么适合用这个 Bot
学习 Polymarket CLOB 机制	模拟交易 + 实时订单簿，无需真钱就能熟悉操作
监控预测市场概率变化	多市场同时盯盘，发现价格异常、流动性异常
概率边缘策略研究	内置公平概率模型，可以自行扩展更多信号逻辑
预测市场套利发现	YES+NO 价差、跨市场价差检测
交易机器人二次开发	源码结构清晰（`core/`、`tui/`），可扩展新策略

六、坑与注意

⚠️ 地区限制

Polymarket 在部分司法管辖区（包括美国）有访问限制。Bot 不提供地理位置绕过，使用前请确认当地法规。

⚠️ 策略信号不等于盈利保证

内置策略均为 educational 性质，不构成投资建议。回测结果不代表未来表现。

⚠️ 实盘密钥安全

config.toml 权限必须是 0600
建议使用硬件钱包或专属 EOA 而非主账号私钥
Bot 代码中没有任何自动转账逻辑，但私钥在内存中解密后会被 Bot 进程持有

⚠️ WebSocket 连接稳定性

CLOB 订单簿通过 WebSocket 推送，网络不稳定时可能出现订单簿数据滞后，建议配合 tmux 或 screen 保持 Bot 持续运行。

⚠️ Python 依赖版本

requirements.txt 中某些包（如 websockets）版本兼容性较严格，建议在虚拟环境中安装，避免与系统其他 Python 包冲突。

⚠️ 策略阈值需自行校准

内置的 probability-edge 阈值（conf > 0.7 等）是示例值，实际使用需要根据具体市场的历史胜率自行调整。

七、与同类对比

工具	特点	与本 Bot 对比
Polymarket 官方网页版	图形界面，手工操作	本 Bot 提供键盘驱动 TUI + 自动策略扫描
python-polymarket	仅 API 封装，无 UI	本 Bot 在此基础上构建了完整 TUI 和策略引擎
Delta Exchange / FTX	传统合约交易	本 Bot 专为预测市场 YES/NO 二元概率设计
自行写 Python 脚本	灵活性高	本 Bot 提供现成订单簿解析、信号计算、持仓追踪

八、一句话结论

Polymarket-Perpetual-Bot 是预测市场玩家的首选开源终端工具——如果你想在一个键盘驱动的界面里同时监控多个 CLOB 市场、跑概率边缘策略、并用模拟盘验证想法，它是目前最完整的开源方案；但实盘使用前务必充分理解风险，并确保 API 密钥安全。