prediction-arbitrage-scout

预测市场套利侦察（Polymarket ↔ Kalshi）

只读侦察工具，用于识别 Polymarket 和 Kalshi 预测市场之间潜在的价格差异。

用途

发现 Polymarket 和 Kalshi 之间价格存在差异的候选市场。
此技能用于发现、研究和确定优先级，而非自动交易或执行交易。

非目标

• 不执行交易
• 不保证盈利
• 不建模滑点、深度或流动性
• 不进行仓位规模计算或风险管理

采取任何行动前，都必须根据 Kalshi 订单簿和市场规则验证此技能的输出。

概述

工作流：

1. 获取 Polymarket 当前公开市场价格
2. 获取 Kalshi 当前开放的公开市场
3. 使用模糊字符串相似度匹配事件
4. 扣除基本费用后计算理论价格差异
5. 生成 CSV 和 Markdown 报告以供审阅

结果按显著价格差异排序，而非按可交易优势排序。

先决条件

工具：

• Read
• Write
• Bash (python)
• Glob
• Grep
• WebFetch

环境：

• Python 3.x

软件包：

• requests
• pandas

安装： pip install requests pandas

说明

步骤 1：获取 Polymarket 数据 命令： python {baseDir}/scripts/fetch_polymarket.py

输出：

• polymarket_data.json

步骤 2：获取 Kalshi 数据 命令： python {baseDir}/scripts/fetch_kalshi.py

输出：

• kalshi_data.json

步骤 3：检测价格差异 命令： python {baseDir}/scripts/detect_arbitrage.py

说明：

• 使用模糊字符串相似度（默认阈值：0.7）
• 比较各平台的 YES/NO 价格
• 估算扣除基本费用后的理论价差

输出：

• arbitrage_opportunities.csv

步骤 4：生成摘要报告 命令： python {baseDir}/scripts/generate_report.py

输出：

• arbitrage_report.md

输出

• polymarket_data.json：Polymarket 原始市场数据
• kalshi_data.json：Kalshi 原始市场数据
• arbitrage_opportunities.csv：按差异排序的列表
• arbitrage_report.md：供审阅的摘要报告

错误处理

Polymarket API 错误：

• 确认 Polymarket API 是否可用
• 稍等片刻后重试

Kalshi API 错误：

• 确认公开端点是否可用
• 部分端点可能需要身份验证；此技能仅使用公开数据

未找到匹配事件：

• 提高模糊匹配阈值
• 手动映射高价值系列

价格数据不足：

• 确保两个平台上都存在 YES 和 NO 价格

解读指南

• 将所有输出视为信号，而非决策
• 验证市场结算规则
• 检查流动性和订单簿深度
• 考虑时机和波动性
• 采取行动时，优先选择手动映射的事件，而非模糊匹配的事件

资源

• Polymarket 数据获取脚本：{baseDir}/scripts/fetch_polymarket.py
• Kalshi 数据获取脚本：{baseDir}/scripts/fetch_kalshi.py
• 差异分析器：{baseDir}/scripts/detect_arbitrage.py
• 报告生成器：{baseDir}/scripts/generate_report.py

用法

运行完整的侦察流程： python {baseDir}/scripts/fetch_polymarket.py python {baseDir}/scripts/fetch_kalshi.py python {baseDir}/scripts/detect_arbitrage.py python {baseDir}/scripts/generate_report.py

可调用此技能自动执行完整工作流。