polymarket-trader

核心用法

Polymarket Trader 是一套专为 Polymarket 平台 BTC 1小时涨跌预测市场设计的策略开发与调试工具。其核心工作流围绕"锚定-计算-交易-验证"四步展开：首先确认目标市场类型为 bitcoin-up-or-down-* 1小时市场；随后从 Binance BTCUSDT 获取1分钟K线数据，计算波动率（sigma）和到期时间，转换为涨跌的公平概率；仅在公平概率与市场价格的差值（edge）超过阈值时入场，并设置方向性保护避免逆势操作；最后根据入场模式（模型驱动或均值回归）执行对应的退出逻辑，并通过 events.jsonl 和 state.json 日志验证每笔交易的合理性。

工具包含三个配套脚本：：binance_klines.py 用于获取Binance K线数据；binance_regime.py 计算5/15分钟收益率和10周期斜率等市场状态指标；explain_fills.py 则解析交易记录，输出包含公平概率、Z分数和趋势判断的明细表，帮助快速定位问题交易。

显著优点

1. 数据源权威性：直接锚定 Binance——Polymarket BTC 1h 市场的官方结算来源，消除价格源不一致带来的系统性偏差。
2. 策略透明度高：完整的数学模型文档（strategy.md）和可审计的 Python 脚本，便于理解、修改和回测。
3. 零外部依赖：仅使用 Python 标准库，无 pip 包管理风险，部署简单且可复现。
4. 调试友好：explain_fills.py 将复杂交易记录转化为结构化表格，显著缩短策略迭代周期。
5. 模块化设计：数据获取、状态计算、交易解释三个脚本解耦，可独立使用或嵌入更大工作流。

潜在缺点与局限性

• 市场单一性：当前仅优化于 BTC 1h Up/Down 市场，其他资产或时间周期需自行调整参数。
• 非实时交易：脚本设计为离线分析和参数扫描，不直接对接 Polymarket 或 Binance 交易 API，生产环境需额外开发。
• 简化假设：公平概率模型基于历史波动率外推，未纳入订单簿深度、资金费率、新闻事件等微观结构因素。
• 路径硬编码：explain_fills.py 默认读取固定路径的 events.jsonl，跨平台或自定义目录时需手动修改。

适合的目标群体

• 量化策略研究员：需要快速验证 Polymarket 预测市场定价效率的学术或业余研究者。
• Polymarket 活跃交易者：希望系统化分析历史交易、识别边缘衰减模式的进阶用户。
• Crypto 衍生品开发者：探索将 CEX 数据作为 DEX/预测市场定价锚点的工程团队。
• 策略回测爱好者：偏好本地离线分析、对代码可控性要求高的个人投资者。

使用风险

• 财务风险：策略回测表现不代表未来收益，Polymarket 存在无常损失和流动性风险，脚本本身不提供资金管理建议。
• API 限制：Binance 公开 API 有速率限制（约1200请求/分钟），高频参数扫描可能触发限流。
• 网络依赖：脚本运行需稳定访问 Binance API，网络中断或 IP 封禁将导致数据获取失败。
• 数据时效性：1分钟K线数据存在发布延迟，极端行情下锚定价格可能与实际结算价偏离。
• 来源可信度：代码来自个人开发者账号（T3），虽经安全审计，但长期维护和漏洞响应能力未经验证。