Prediction-Markets-Trading-Bot-Toolkits 是什么?

Prediction Market Toolkits 是一套用 Rust 编写的预测市场自动交易机器人工具集,目标平台为 Polymarket、Kalshi、Limitless 等预测/事件合约市场。仓库收录了十个独立策略机器人(跟单、BTC 短窗套利、跨平台套利、方向猎手、价差做市、体育下注执行、临近结算狙击、订单簿失衡、做市、链上巨鲸信号),它们共用同一套执行核心、风控层和「平台无关」的适配器栈,并带一个终端 TUI 界面和一个用于展示的 React 落地页。需要明确两点:其一,这是面向真实资金的金融交易工具,涉及实际亏损风险;其二,README 行文带有较重的营销色彩(如「接近免费的钱」「保证 1 美元结算」等表述),并主要通过 Telegram 联系作者,阅读时应把宣传话术与可核实的代码事实区分开。

⭐ 27 Stars 🍴 5 Forks Rust MIT 作者: haredoggy
来源:README 标题与 Strategies/Engine/Safety 段、Cargo.toml package 描述、仓库目录树(src/bot 十个策略、src/service、src/ui、landing) 查看 GitHub 仓库 →

为什么值得关注

预测市场(Polymarket、Kalshi 等)在 2024–2025 年随大选、体育、加密事件持续放量,围绕它们的自动化交易与套利工具因此受到关注。该仓库把跟单、跨平台套利、做市、链上巨鲸跟踪等十类常见量化玩法集中在一个 Rust 代码库里,并配了截图丰富、措辞抓眼球的 README 和独立落地页,传播性较强。但需理性看待热度来源:仓库仅约 241 星、无正式 Release、提交历史有限,README 充斥「42ms 极速」「3–30 秒领先」「保证结算」等强营销表述,且大量引导到作者 Telegram,更像是一个兼具展示与引流性质的项目,而非经过广泛生产验证、社区驱动的成熟基础设施。

来源:GitHub meta(stars 241、created_at 2025-09-29、无 releases)、README 营销话术与 Contact 段、commits 数量有限

核心功能

跟单交易(Copy Trading)

追踪一个或多个高收益钱包,按可配置比例镜像其买卖动作,支持最小下单额、断路器阈值与 dry-run。本质是把策略判断外包给被跟踪钱包,被跟对象一旦失误或行为反常会被原样放大。

来源:README「1. Copy Trading」段、src/bot/copy_trading.rs
短窗与跨平台套利

包含 BTC 5/15/60 分钟 Up/Down 窗口套利,以及 Polymarket↔Kalshi 同一市场跨平台价差套利(对冲两腿、赚取价差)。README 宣称端到端约 42ms,但实际收益高度依赖延迟、手续费、滑点与两平台流动性,跨平台还涉及资金分布与提现摩擦。

来源:README「2. BTC Arbitrage」「3. Cross-Market Arbitrage」段、src/bot/arbitrage.rs、src/bot/cross_market_arb.rs
方向猎手与价差farming

方向猎手按可配置的动量/订单流条件入场并用 TP/SL 自动出场;价差 farming 在买卖盘口反复吃微小价差。两者都属于高频规则化策略,对参数和市场状态敏感。

来源:README「4. Direction Hunting」「5. Spread Farming」段、src/bot/direction_hunting.rs、src/bot/spread_farming.rs
临近结算狙击与订单簿失衡

结算狙击扫描接近确定性(如 ≥95% YES)的市场买入并持有到结算;订单簿失衡(OBI)按盘口买卖深度比超阈值时顺势入场。README 把前者描述为「接近免费的钱」,但「近确定」并不等于确定,黑天鹅、结算争议、流动性不足都可能使其亏损。

来源:README「7. Resolution Sniper」「8. Orderbook Imbalance」段、src/bot/resolution_sniper.rs、src/bot/orderbook_imbalance.rs
做市与体育下注执行

做市机器人双边挂 GTD 单赚价差,并按库存偏移自动重新报价、成交后撤对侧腿;体育执行提供面向 NBA/NFL/足球等实时盘的快速下单界面。做市在低流动性预测市场承担库存与逆向选择风险。

来源:README「6. Sports Betting」「9. Market Making」段、src/bot/market_maker.rs、src/bot/sports_execution.rs
链上巨鲸信号(Whale Signal)

直接订阅 Polygon 区块数据,过滤被追踪大额钱包与 Polymarket CLOB 合约的交互,解码 calldata(token id、size、side)并即时跟随,宣称比公开持仓 API 早 3–30 秒。这是项目中较有技术含量的部分,但「跟随巨鲸」同样把判断外包给他人。

来源:README「10. On-Chain Whale Signal」段、src/bot/whale_signal.rs、src/service/onchain.rs

技术架构

代码库是一个 Rust 二进制项目(crate 名 polymarket-toolkits),核心目录划分清晰:src/bot/ 放十个策略实现(arbitrage、copy_trading、cross_market_arb、direction_hunting、market_maker、orderbook_imbalance、resolution_sniper、sports_execution、spread_farming、whale_signal);src/service/ 是共享执行与基础设施层,包括 clob(中心限价订单簿交互)、order_executor(下单)、risk_guard(风控)、position_monitor/position_store(持仓监控与存储)、market_cache、midprice、onchain(链上订阅)、eligibility、parse、strategy;src/ui/ 提供基于 ratatui 的终端界面,src/config.rs 与 src/models.rs 管理配置与数据模型。整体采用 tokio 异步运行时,通过 reqwest/WebSocket 与各交易平台 REST/WS 接口通信,用 alloy 系列库做 Polygon 链上签名与 ABI 解码。仓库另含一个独立的 landing/ React+Vite 落地页用于项目展示,与交易核心无关。安全层提供断路器(连续大额交易触发熔断)、深度守卫(下单前校验盘口流动性)、dry-run(全链路空跑不真实下单)和最小下单额限制。

来源:仓库递归目录树、Cargo.toml 依赖、README「Engine」「Safety」段

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) reqwest 0.12(rustls-tls,REST 调用)reqwest 0.12(… tokio-tungstenite 0.24(WebSocket 行情/订单流)tokio-tungsten… alloy-primitives/sol-types/signer/dyn-abi 0.8(Polygon 签名与 ABI/calldata 解码、EIP-712)alloy-primitiv… clap 4(CLI) serde / serde_json / serde_yaml(配置与序列化)serde / serde_… 跟单交易(Copy Trading)跟单交易(Copy Tradi… 短窗与跨平台套利 方向猎手与价差farming 临近结算狙击与订单簿失衡临近结算狙击与订单簿失… 做市与体育下注执行 链上巨鲸信号(Whale Signal)链上巨鲸信号(Whale S… Prediction-Markets-T… 项目本体 核心功能 关键依赖

中心为项目本体,内环 = 核心功能模块,外环 = 关键技术依赖;按 deep.json 中的 core_features 与 tech_stack.key_deps 自动生成

技术栈

语言Rust(edition 2021,要求 rust 1.70+)框架tokio 异步运行时 + 自研策略/执行框架;ratatui+crossterm 终端 UI
reqwest 0.12(rustls-tls,REST 调用)tokio-tungstenite 0.24(WebSocket 行情/…alloy-primitives/sol-types/signer/dy…clap 4(CLI)serde / serde_json / serde_yaml(配置与序…tracing(结构化日志)
单体 Rust 二进制,终端 TUI 运行;通过配置 config.json/config.yaml 控制;landing 子目录为 React+Vite+Tailwind 展示页,经 GitHub Actions 部署
来源:Cargo.toml 依赖清单、landing/ 目录与 .github/workflows/deploy-landing.yml

快速上手

仓库无预编译 Release,需自行从源码构建。前置为 Rust 1.70+ 工具链;克隆后用 cargo build --release 编译,二进制名为 polymarket-toolkits。运行前先复制 config.yaml.example 为自己的配置并按平台接入与策略参数填写。强烈建议首次使用时把交易开关置为 enable_trading: false(dry-run),完整空跑一整个会话确认行为符合预期后,再用「仅放入愿意承担损失的资金」的专用钱包小比例试跑(如 copy_percentage 5–10%)。任何真实下单前务必确认符合对应平台(Polymarket/Kalshi/Limitless)的服务条款与你所在司法辖区的法规。
来源:README「Safety」Recommendations 表与 Disclaimer、config.yaml.example、Cargo.toml(无 releases)

使用场景

适用对象主要是已经熟悉预测市场、量化交易和 Rust 的技术型交易者,用于在 Polymarket/Kalshi/Limitless 上自动执行跟单、套利、做市、巨鲸跟随等策略,并借终端 TUI 集中监控持仓与风控状态。对开发者而言,src/service 中的 CLOB 交互、链上 calldata 解码、风控/断路器实现也可作为学习预测市场对接的参考。需要强调:它不适合不了解市场机制或无法承受本金损失的用户——所有策略都涉及真实资金风险,README 中的延迟、胜率与「保证结算」等说法应自行验证,不应作为收益预期。

来源:README Strategies/Safety/Disclaimer 段、src/service 目录

优势与局限

优势

  • 用 Rust + tokio 实现,并发与延迟特性适合对执行速度敏感的交易场景,依赖选型(alloy、tokio-tungstenite、ratatui)规范。
  • 把十类常见预测市场策略与共享的执行/风控/适配层组织在一个清晰分层的代码库中,并提供链上区块订阅这类有一定技术含量的能力。
  • 内置 dry-run、断路器、深度守卫、最小下单额等基本风控,文档也给出了从空跑到小比例上线的渐进建议。

局限

  • 金融风险是首要前提:所有策略针对真实资金,可能造成实际亏损;README 的「接近免费的钱」「保证 1 美元结算」「95%+ 必胜」等表述夸大了确定性,近确定事件仍可能因黑天鹅、结算争议或流动性枯竭而亏损。
  • 合规与法律风险:在部分司法辖区,预测市场/事件合约交易、自动化下单或套利可能受限甚至违法,使用前必须自行确认平台 ToS 与当地法规,本项目不构成投资建议。
  • 项目成熟度与可信度有限:约 241 星、无正式 Release、提交历史不长,README 营销色彩浓且大量引流至作者 Telegram,宣称的性能/胜率缺乏独立验证,需谨慎对待。
  • 依赖外部平台接口的稳定性与费率,跨平台套利还面临资金分布、提现摩擦与对手方风险,实际净收益往往远低于理想模型。
来源:Cargo.toml 与目录结构、README Engine/Safety/Disclaimer 段、GitHub meta(stars/releases/commits)

最新版本

仓库未发布任何正式 Release,Cargo.toml 中版本为 0.1.0,需从源码自行构建。代码仍在维护,最近一次推送在 2026-05-20。

来源:GitHub releases(0 个)、Cargo.toml version=0.1.0、meta pushed_at 2026-05-20

总结评价

这是一套技术实现具体、覆盖面较广的 Rust 预测市场交易机器人合集,对已经在 Polymarket/Kalshi 等平台做量化、且具备 Rust 与风险承受能力的交易者,可作为策略与对接实现的参考。但必须把它当作高风险金融工具看待:README 的营销话术(极速、必胜、保证结算)远超可验证的事实,项目星标少、无 Release、引流痕迹明显,宣称指标都需自行复核。任何人在投入真实资金前,都应先长时间 dry-run、用专用钱包小额验证,并确认所在地区对预测市场交易的合法性。不了解市场机制或无法承受亏损者,不建议使用。

来源:综合 README、Cargo.toml、目录结构与 GitHub meta 的事实判断
透明度声明
本页内容由 AI(大语言模型)基于以下公开材料自动生成:GitHub README、代码目录结构、依赖文件、Release 信息。 分析时间: 2026-05-23 17:39. 质量评分: 100/100.

数据来源:README、GitHub API、依赖文件