polymarket-arbitrage

核心用法

Polymarket Arbitrage 是一套用于监控预测市场套利机会的 Python 工具集，主要面向 Polymarket 平台。该技能通过三个核心脚本实现完整工作流：：fetch_markets.py 抓取市场数据，，detect_arbitrage.py 分析套利机会，，monitor.py 提供持续监控与警报。用户可通过命令行参数配置最小利润率阈值（建议 3-5%）、监控间隔等参数，输出 JSON 格式的市场数据和套利机会清单。

该技能检测两类主要套利：数学套利（多结果市场概率和不等于 100%）和跨市场套利（同事件不同定价）。其中买入型数学套利（概率和 <100%）被标记为最安全的策略，卖出型则需要更多经验和资本。工具内置 2% 交易费用的保守估算，自动计算净收益率。

显著优点

风险控制完善：技能内置四层风险管理机制——单仓位不超过本金 5%、最小净收益率 3%、日亏损上限 10%、优先买入型套利。这种渐进式风险控制设计在开源交易工具中较为罕见，体现了开发者对零售用户保护的重视。

学习曲线友好：明确划分四个实践阶段，从纸面交易（1-2 周）到微型实盘（$50-100）、规模扩展（$500）再到未来自动化，每个阶段都有清晰的决策检查点。这种结构化入门路径降低了预测市场套利的认知门槛。

透明度与可审计性：代码完全开源，依赖仅 requests 和 beautifulsoup4 两个广泛维护的库，无隐藏的网络请求或数据收集行为。所有数据存储在本地 JSON 文件，用户可完全掌控自己的分析数据。

潜在缺点与局限性

数据时效性瓶颈：该技能依赖抓取 Polymarket 主页数据，而主页显示的是中点价或滞后价格，非实时订单簿。开发者明确警告"真实套利机会在数秒内消失"，检测到的 3-5% 收益率机会在实际执行时可能已不存在。这是网页抓取类工具的根本性限制，无法通过代码优化解决。

执行缺口：技能仅提供分析，所有交易需用户在 Polymarket 网站手动完成。从检测到机会到完成多腿交易存在显著的时间延迟，在高竞争套利环境中处于劣势。

地理与合规限制：Polymarket 在美国等多个司法管辖区受限，用户需自行确认本地法规。此外，Polygon 网络的 gas 费用和 USDC 出入金成本未被纳入收益率计算。

策略容量有限：预测市场套利属于容量受限策略，随着参与者增加，边缘机会迅速衰减。技能文档中提到的"每周 3-5 个好机会"在当前市场环境下可能过于乐观。

适合的目标群体

量化交易学习者：希望理解市场无效性、套利定价原理的学生和初级量化研究员，可通过纸面交易阶段建立对预测市场微观结构的认知。

小额资本实验者：拥有 $500-$5000 可承受损失资金、希望体验真实市场套利但不愿投入大量开发资源的个人交易者。

策略验证开发者：计划构建自动化套利系统的开发者，可将此技能作为数据获取和信号生成的原型基础，后续替换为 WebSocket 实时数据流和 API 执行。

不适合：寻求稳定收益的普通投资者、无法承受本金损失的用户、以及期望"被动收入"的业余交易者。预测市场套利的专业竞争程度和执行难度远高于表面看起来。

使用风险

性能风险：网页抓取频率受 Polymarket 服务器响应限制，默认 5 分钟间隔可能错过快速消失的套利窗口。频繁请求可能导致 IP 临时封禁。

依赖项风险：BeautifulSoup 解析依赖 HTML 结构稳定性，Polymarket 前端改版将导致数据获取失败。建议关注官方 API 发布以迁移至更稳定的数据源。

认知偏差风险：纸面交易阶段的成功可能产生过度自信，导致在实盘阶段违反风险管理规则。技能文档明确警告需完成 20+ 笔微型实盘并盈利后才可进入下一阶段。

平台风险：Polymarket 作为中心化预测市场，存在智能合约风险、监管政策变化风险以及流动性突然枯竭风险。2022 年 CFTC 处罚事件表明该领域监管不确定性较高。