AI教程

在终端中构建并运行 Polymarket 预测机器人

了解如何安装和使用 Polymarket 预测机器人。这是一款键盘驱动的终端仪表盘，可用于浏览市场、查看订单簿、运行概率和流动性策略，以及跟踪模拟持仓。本教程将先从安全的演示模式开始，再介绍实时凭证、操作控制和高级工作流技巧。

AI我搜编辑部2026年9月27日阅读约 9 分钟

什么是 Polymarket 预测机器人？

Polymarket Prediction Bot 是一款开源、键盘驱动的终端应用，用于探索 Polymarket 上的预测市场。它在基于 Textual 和 Rich 的终端界面中，集成了市场浏览器、实时中心限价订单簿视图、策略引擎、持仓跟踪器和成交记录。

Polymarket 市场通常包含 YES 和 NO 份额，这些份额会根据现实事件的结果结算为 $1 或 $0。由于市场价格可以理解为隐含概率，机器人会将市场价格与公平概率估计进行比较，分析订单簿状况，并提示潜在的优势或套利信号。

重要提示：这是一个非官方的教育项目，与 Polymarket 没有关联。它不构成金融建议，所包含的任何策略也都不保证盈利。请从 --demo 开始，该模式使用内置数据集和模拟成交，不会接触钱包。

主要功能

市场浏览器：按交易量、价差、类别以及距离结算的剩余时间筛选市场。
CLOB 订单簿：查看 YES 和 NO 的买单与卖单、价差、中间价以及订单簿失衡情况。
策略引擎：单独或组合运行概率优势、订单簿失衡和流动性策略。
信号跟踪：查看建议方向以及从 0 到 1 的置信度数值。
持仓监控：跟踪未平仓的 YES 和 NO 数量、平均成本、以 USDC 计价的未实现盈亏以及结算倒计时。
成交记录：在本地保存信号、模拟成交或 CLOB 成交以及撤单记录。
仪表板：查看涨跌幅最大的市场、价差较大的市场、即将结算的市场以及排队中的信号。
模拟交易：在配置实时访问权限前，使用虚拟 USDC 余额测试交易流程。
风险控制：设置最大 USDC 敞口、单市场上限以及每日亏损限额。
跨平台界面：可在 Windows、macOS 或 Linux 上运行应用。

前置条件

标准安装需要 Git、Python 3.11 或更高版本以及 pip。仓库还提供一键启动器，首次使用时会解包内置的独立解释器，因此使用这些启动器时无需安装系统 Python。

使用 Python 安装机器人

克隆仓库：

git clone https://github.com/gulelmatthews/Polymarket-Perpetual-Bot.git

进入项目目录：
```
cd Polymarket-Perpetual-Bot
```
安装所需软件包：
```
pip install -r requirements.txt
```
使用内置演示数据集启动：
```
python main.py --demo
```

项目还提供通过 python -m polymarket_bot 启动的软件包入口点。其命令行解析和启动逻辑在主机软件包中实现。

使用一键启动器

Windows

运行随附的批处理启动器：

run.bat

Linux 和 macOS

为 shell 启动器添加可执行权限，然后运行：

chmod +x run.sh
./run.sh

首次使用时，这些启动器会解包应用所需的内置独立解释器。

浏览终端仪表板

界面分为六个主要视图。使用数字键可直接在各视图之间切换：

1：仪表板
2：市场
3：订单簿
4：策略
5：持仓
6：日志

其他键盘控件可支持主要工作流程：

/：筛选市场列表。
Enter 或 b：打开所选市场的 CLOB 订单簿。
s：在关注列表上运行策略引擎。
o：创建模拟订单。
t：循环切换可用主题。
q：退出应用。

基本演示流程

使用 python main.py --demo 启动应用。
按 2 打开市场浏览器。
使用 /，根据可用筛选条件缩小显示的市场范围。
选择一个市场，然后按 Enter 或 b 查看其 YES 和 NO 订单簿。
查看最佳买单和卖单、价差、中间价以及相对数量失衡情况。
按 s，使用已启用的策略扫描关注列表。
按 4 打开策略视图，查看每个信号的置信度和建议方向。
需要测试信号时，按 o 创建模拟订单。
使用 5 查看持仓和未实现盈亏，然后使用 6 查看信号及模拟成交。

了解内置策略

概率优势策略

该策略会将市场价格与公平概率模型进行比较。当两者差异超过配置的阈值时，策略会生成信号。例如，如果模型给出的公平概率明显高于当前 YES 价格，生成的信号可能会建议 YES 方向。

该信号的质量取决于提供给策略的公平概率模型。请将置信度视为分析结果，而不是保证。

订单簿失衡策略

盘口失衡策略会考察 YES 和 NO 两侧可用挂单量的相对大小。较大的数量偏斜可以作为方向性线索，但这只是订单簿信息，并不能证明市场会朝该方向移动或以该方向结算。

流动性策略

流动性策略会寻找较大的价差，以及价格可能向中点均值回归的机会。较大的价差可能带来机会，但也可能表明流动性不足或执行风险较高。

跨市场信号

机器人可以发现 YES 加 NO 价差和多结果套利信号。评估这些信号时，应结合可用流动性、订单簿深度和风险限额，而不应将其视为自动获利机会。

配置实盘模式

实盘模式需要你自己的 Polymarket API 凭据。请在 ~/.polymarket-bot/config.toml 创建配置文件，结构如下：

[auth]
private_key    = "0x…"
proxy_address  = "0x…"
api_key        = "…"
api_secret     = "…"
api_passphrase = "…"
endpoint       = "https://clob.polymarket.com"

private key 是 Polygon EOA 私钥，而 proxy_address 是 Polymarket 代理地址或签名者地址。应用只会从此本地配置文件读取凭据。

在支持 Unix 文件权限的系统上，请限制该文件的访问权限：

chmod 0600 ~/.polymarket-bot/config.toml

安全警告：切勿将配置文件、私钥、API secret 或 passphrase 提交到源代码管理系统。项目声明密钥会保留在本地，且不会被记录到日志中。

配置凭据后，可以通过以下命令启动实盘模式：

python main.py

实盘下单必须经过明确配置才能启用。请先在演示模式中验证设置，确认风险敞口控制，并检查 Polymarket 是否在你所在的司法辖区提供服务。项目不会绕过地理围栏限制。

高级使用技巧

结合策略上下文

内置策略可以选择并组合使用。不要只依据单一指标操作，而应比较概率优势、订单簿失衡、价差宽度和信号置信度。多个指标相互印证可以提供更多背景信息，但仍无法消除交易风险。

考虑信号前检查流动性

显示的市场价格并不能说明该价格可以执行多少数量。评估优势或套利信号前，请打开订单簿，检查买卖盘深度、价差、中点和失衡情况。

将日志作为操作记录

机器人会记录信号、成交和撤单。查看日志有助于将策略输出与之后的模拟结果进行比较，并找出高置信度信号未按预期表现的情况。

监控结算时间

使用市场浏览器和仪表板找出即将结算的市场。结算时间会影响资金可能处于风险敞口中的时长，而持仓视图会显示开放市场的倒计时。

实盘使用前应用风险控制

配置并遵守可用的最大 USDC 敞口、单市场上限和每日亏损限额。当策略连接到实盘下单模板时，这些控制尤其重要。

分离演示和实盘工作流

学习键位、测试策略组合和观察模拟成交时，请使用 --demo。只有在确认界面、信号解读和风险设置均按预期运行后，才应切换到需要凭据的实盘模式。

项目结构

该仓库将命令行启动、配置、策略逻辑、数据模型和终端界面分开组织：

polymarket-prediction-bot/
├── main.py
├── polymarket_bot/
│   ├── __main__.py
│   ├── cli.py
│   ├── config.py
│   ├── core/
│   └── tui/
├── support/
├── requirements.txt
├── run.bat
├── run.sh
└── release/

main.py 是主要入口，而 polymarket_bot/core/ 包含模型、策略引擎和模拟数据。polymarket_bot/tui/ 目录包含 Textual 界面、组件和样式。release/ 目录预留用于计划中的预编译二进制文件。

结语

Polymarket Prediction Bot 提供统一的终端工作流，用于浏览预测市场、检查 CLOB 流动性、生成策略信号，以及跟踪持仓和成交。请从 python main.py --demo 开始，熟悉键盘驱动的界面，在上下文中评估信号，并在考虑使用需要凭据的实盘模式前实施严格的敞口控制。

该项目根据 MIT License 发布，定位是独立的教育工具包，而非金融建议。