Polymarket BTC 15m Assistant 实时交易助手详细部署教程

Polymarket BTC 15m Assistant 是一个为 Polymarket “比特币15分钟涨跌”预测市场设计的实时终端交易助手。它能聚合链上和交易所价格、技术指标，并提供简易的交易信号，帮助您做出更明智的决策。本教程将指导您完成从安装到运行的每一步。

📋 目录

项目是什么
核心功能
系统要求与准备
安装步骤
配置详解
运行与使用
更新与卸载
常见问题排查
风险提示

项目是什么

这是一个用 Node.js 编写的命令行工具，专为交易 Polymarket 上 “比特币15分钟涨跌” 合约的用户设计。它通过一个实时刷新的控制台界面，为您提供关键的市场信息和简易的交易信号。

数据来源与计算：

Polymarket 市场数据：当前市场的实时价格和流动性。
实时价格源：通过 Polymarket WebSocket 获取 Chainlink 提供的 BTC/USD 实时价格（与 Polymarket UI 显示一致），并备有 Polygon 链上数据作为备用。
参考价格：从币安 (Binance) 获取的 BTC 现货价格，用于对比。
技术指标：在实时价格基础上计算短期技术分析快照，包括：
- Heiken Ashi 平滑K线
- RSI (相对强弱指标)
- MACD (指数平滑异同移动平均线)
- VWAP (成交量加权平均价格)
- 1分钟和3分钟价格变化率 (Delta)
交易信号：基于上述技术指标的综合评分，给出一个简单的做多 (LONG) 或做空 (SHORT) 百分比建议。

核心功能

实时数据聚合：在一个终端界面同时查看市场赔率、真实价格源、参考价格和技术指标。
自动化市场选择：默认自动选择最新的15分钟市场，也可手动指定特定市场。
多数据源容灾：主数据源（Polymarket WS）失效时，自动切换至链上 RPC 备用数据源。
代理支持：支持通过 HTTP/HTTPS/SOCKS5 代理运行，适应不同网络环境。

系统要求与准备

软件要求

Node.js：版本 18 或更高。您可以在终端运行 node -v 检查版本。
npm：随 Node.js 一起安装。
Git (可选)：用于克隆仓库，也可以直接下载 ZIP 文件。

网络要求

能够访问 polymarket.com 和相关 RPC 节点（如 polygon-rpc.com）。
如果网络受限，需要准备一个可用的代理。

安装步骤

步骤 1：获取项目代码

方法一：使用 Git 克隆（推荐）

1	git clone https://github.com/FrondEnt/PolymarketBTC15mAssistant.git

方法二：下载 ZIP 文件

访问项目 GitHub 页面。
点击绿色的 <> Code 按钮，选择 Download ZIP。
解压 ZIP 文件。

步骤 2：进入项目目录

1	cd PolymarketBTC15mAssistant

步骤 3：安装依赖

1	npm install

此命令会根据 package.json 自动下载并安装项目所需的所有 Node.js 包。

配置详解

项目可以通过环境变量进行配置。您可以在终端会话中临时设置，或创建 .env 文件进行持久化管理（本项目未内置 .env 加载器，推荐使用终端设置或您自己的加载方式）。

1. 基础配置（可选，有默认值）

以下配置通常无需修改：

环境变量	默认值	说明
`POLYMARKET_AUTO_SELECT_LATEST`	`true`	为 `true` 时自动选择最新的15分钟市场
`POLYMARKET_SERIES_ID`	`10192`	Polymarket 系列 ID
`POLYMARKET_SERIES_SLUG`	`btc-up-or-down-15m`	Polymarket 系列标识
`POLYMARKET_LIVE_WS_URL`	`wss://ws-live-data.polymarket.com`	Polymarket 实时数据 WebSocket 地址
`CHAINLINK_BTC_USD_AGGREGATOR`	`0xc907E116054Ad103354f2D350FD2514433D57F6f`	Chainlink BTC/USD 喂价合约地址

2. 关键配置：指定目标市场（可选）

默认情况下，助手会自动选择最新市场。如果你想固定监控某个特定的市场，可以设置其 slug：

# Windows PowerShell
$env:POLYMARKET_SLUG = "btc-updown-15m-2026-01-29"   # 示例，请替换为实际 slug

# Windows CMD
set POLYMARKET_SLUG=btc-updown-15m-2026-01-29

市场的 slug 可以从 Polymarket 市场页面的 URL 中获取。

3. 重要配置：优化数据源稳定性

为了确保数据稳定，强烈建议配置至少一个 Polygon RPC 备用节点。

Windows PowerShell (当前终端会话)：

# 设置一个或多个 HTTP RPC 备用节点
$env:POLYGON_RPC_URLS = "https://polygon-rpc.com,https://rpc.ankr.com/polygon"

# 设置 WebSocket RPC 备用节点（推荐，更实时）
$env:POLYGON_WSS_URLS = "wss://polygon-bor-rpc.publicnode.com"

Windows CMD (当前终端会话)：

1 2	set POLYGON_RPC_URLS=https://polygon-rpc.com,https://rpc.ankr.com/polygon set POLYGON_WSS_URLS=wss://polygon-bor-rpc.publicnode.com

4. 代理配置（如果需要）

如果您的网络需要通过代理访问，可以设置标准代理环境变量。

支持的类型：HTTP_PROXY / HTTPS_PROXY / ALL_PROXY

PowerShell 示例：

1
2
3

$env:HTTPS_PROXY = "http://127.0.0.1:7890"
# 或使用 SOCKS5
$env:ALL_PROXY = "socks5://127.0.0.1:1080"

带认证的代理：
代理 URL 格式为 http://USERNAME:PASSWORD@HOST:PORT。如果密码包含特殊字符（如 @, :），需要先进行 URL 编码。

例如密码 p@ss:word 应编码为 p%40ss%3Aword。

运行与使用

启动助手

在项目目录的终端中执行：

npm start

界面解读

启动后，终端会显示一个实时刷新的静态信息面板，通常包含以下区域：

市场信息：当前监控的市场名称、结束时间、UP/DOWN 价格和流动性。
实时价格：来自 Polymarket Chainlink 喂价和备用源的 BTC/USD 价格。
参考价格：来自币安的 BTC 现货价格。
技术指标快照：最新计算的 Heiken Ashi, RSI, MACD, VWAP 和 Delta 值。
交易信号：基于上述指标给出的 LONG/SHORT 百分比建议。

停止助手

在终端中按下 Ctrl + C 即可停止运行。

更新与卸载

更新到最新版本

1
2
3

git pull       # 拉取最新代码
npm install    # 更新依赖
npm start      # 重新启动

卸载

由于这是一个无需安装的脚本项目，卸载只需删除整个项目文件夹即可。

常见问题排查

问题：启动后长时间没有显示 Chainlink 价格更新。

解决：
1. Polymarket WebSocket 可能暂时不可用，脚本会自动切换到 RPC 备用源。请确保配置了有效的 POLYGON_RPC_URLS。
2. 检查网络连接，确保可以访问配置的 RPC 节点。

问题：终端显示乱码或界面刷新异常。

解决：确保终端使用的字体和字符编码支持标准输出。部分终端对 readline.cursorTo 等刷新命令的支持可能不完美，可尝试在 Windows Terminal 或 VS Code 的集成终端中运行。

问题：运行 npm start 报错，提示缺少依赖。

解决：确保已正确运行 npm install。如果依然报错，可以尝试删除 node_modules 文件夹和 package-lock.json 文件，然后重新运行 npm install。

风险提示

重要声明：

本工具仅供教育和研究参考，不构成任何投资或交易建议。
所有交易决策和结果风险自担。加密货币和预测市场交易风险极高，可能导致本金全部损失。
项目作者和贡献者不对使用本工具产生的任何损失负责。

通过以上步骤，您应能成功部署并开始使用 Polymarket BTC 15m Assistant。请务必理解其数据源和指标含义，并结合自己的研究做出独立判断。祝交易顺利！