PolyGlass

Polymarket 链上数据聚合与可视化平台

聚合 Polymarket 链上交易数据与市场元数据，基于 LLM 进行市场趋势分析与异常检测。提供 20,000+ 市场实时浏览、Smart Money 链上追踪、PnL 排行榜、热力图可视化及市场结算日历，为量化团队、DAO 和交易者打造机构级的预测市场数据分析工具。

English | 简体中文

---

✨ 功能特性

📊 Overview - 首页仪表盘

• 实时市场统计 - 总市场数、活跃事件、交易量等核心指标
• 市场热力图 - 按分类/交易量可视化市场活跃度
• 市场轮播卡片 - 随机展示高交易量市场的实时赔率
• 异常交易检测 - 自动识别价格波动、交易量异动等异常信号
• Smart Money 动态 - 实时展示高胜率交易者的最新交易

🏪 Markets - 市场浏览

• 20,000+ 市场数据 - 自动同步 Polymarket Gamma API（≤60s 延迟）
• 多维度筛选 - 按状态（Active/Resolved）、分类标签筛选
• 关键词搜索 - 支持市场标题模糊搜索
• 灵活排序 - 按交易量、结束日期、持仓量排序
• 事件分组 - 按事件展开查看子市场，点击跳转 Polymarket 原站

💰 Smart Money - 链上追踪

• 交易者排行榜 - 按 Score/PnL/ROI/胜率/交易量排名
• Retail 视图 - 过滤 EOA + 有入金记录的真实散户
• 交易者详情 - 点击查看持仓、历史信号、标签
• 钱包搜索 - 输入地址查询任意钱包的交易统计
• Smart Money 事件 - 查看聪明钱在特定事件上的持仓分布

🧠 Insights - AI 分析

• 事件 URL 分析 - 输入 Polymarket 事件链接，LLM 自动生成市场洞察
• 高 ROI 市场推荐 - 展示潜在高回报的市场机会

📅 Calendar - 结算日历

• 时间线视图 - 按日期查看即将结算的预测市场
• 热力图着色 - 颜色深度反映当日市场价值
• 事件预览 - 悬停查看当日结算的具体事件

🔗 钱包连接

• RainbowKit 集成 - 一键连接 MetaMask、WalletConnect、Coinbase 等主流钱包
• Polygon 网络 - 自动切换到 Polygon 网络
• 地址展示 - 连接后显示链信息和缩略地址

---

🏗️ 技术架构

┌─────────────────────────────────────────────────┐
│  前端: Next.js 16 + React 19 + Tailwind CSS 4   │
│  可视化: Recharts + Three.js                     │
│  状态: React Query + Zustand                     │
│  钱包: RainbowKit + wagmi + viem                 │
├─────────────────────────────────────────────────┤
│  API: Next.js API Routes                         │
├──────────────────────┬──────────────────────────┤
│  Gamma API (自动)    │  Polygon RPC (手动)       │
│  市场/事件元数据      │  交易日志/Smart Money     │
│  ≤60s 延迟同步       │  存储到 Turso DB          │
└──────────────────────┴──────────────────────────┘

---

📁 项目结构

PolyGlass/
├── src/
│   ├── app/                    # Next.js App Router
│   │   ├── api/                # API 路由
│   │   │   ├── markets/        #   市场数据接口
│   │   │   ├── smart-money/    #   Smart Money 接口
│   │   │   ├── events/         #   事件接口
│   │   │   ├── leaderboard/    #   排行榜接口
│   │   │   ├── stats/          #   统计接口
│   │   │   └── ...
│   │   ├── markets/            # Markets 页面
│   │   ├── smart-money/        # Smart Money 页面
│   │   ├── insights/           # Insights 页面
│   │   ├── calendar/           # Calendar 页面
│   │   ├── components/         # 页面级组件
│   │   └── hooks/              # 自定义 Hooks
│   ├── markets/                # 模块A: Gamma API 市场数据
│   ├── indexer/                # 模块B: Polygon 链上日志扫描
│   ├── decoder/                # 模块C: 日志解码
│   ├── resolver/               # 模块D: 交易解析与聚合
│   ├── db/                     # 模块E: Turso 数据库操作
│   ├── sync/                   # 数据同步逻辑
│   ├── components/             # 通用 UI 组件
│   ├── lib/                    # 工具库（缓存、日志、wagmi 配置）
│   ├── types/                  # TypeScript 类型定义
│   └── utils/                  # 辅助函数
├── scripts/                    # 数据同步与回填脚本
├── data/                       # 本地缓存数据（gitignore）
└── docs/                       # 项目文档

---

🚀 快速开始

环境要求

• Polygon RPC URL（Smart Money 功能需要）
• Turso 数据库账号（可选，Smart Money 功能需要）

安装

git clone https://github.com/CasualHackathonPolyGlass/PolyGlass.git
cd PolyGlass
pnpm install
cp .env.example .env.local

编辑 .env.local：

# Polygon RPC（Smart Money 功能需要）
POLYGON_RPC_URL=https://polygon-rpc.com

# Turso 数据库（可选，Smart Money 功能需要）
TURSO_DATABASE_URL=libsql://your-db.turso.io
TURSO_AUTH_TOKEN=your-token

# WalletConnect（可选）
NEXT_PUBLIC_WALLET_CONNECT_PROJECT_ID=your-project-id

运行

pnpm dev        # 启动开发服务器 http://localhost:3000
pnpm build      # 构建生产版本
pnpm fetch      # 同步 Smart Money 链上数据

💡 Markets 页面数据从 Gamma API 自动同步，无需手动操作。

---

📊 数据来源

数据类型	来源	同步方式
市场/事件元数据	Polymarket Gamma API	🟢 自动（≤60s 延迟）
实时价格	Polymarket CLOB	🟢 实时
交易记录	Polygon 链上日志	🟡 手动 pnpm fetch
入金/出金	USDC Transfer 事件	🟡 手动 pnpm fetch

关键合约地址 (Polygon)

合约	地址
CTF Exchange	0x4bFb41d5B3570DeFd03C39a9A4D8dE6Bd8B8982E
USDC.e	0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174
Native USDC	0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359

---

🔄 数据同步与回填

自动同步

Markets 页面数据从 Polymarket Gamma API 自动同步，内存缓存 60 秒，部署后无需手动操作。

手动同步

Smart Money 链上数据需要通过脚本手动同步：

pnpm fetch                    # 主同步：拉取最近 3 天的 OrderFilled 链上日志

数据回填

项目提供了一组回填脚本，用于补充历史数据和增强数据维度：

脚本	功能	说明
backfill-origin-type.ts	回填地址类型	识别 EOA / 合约地址
backfill-relayer.ts	回填 relayer 信息	识别代理交易
backfill-deposits.ts	回填 USDC 存款	扫描入金事件

按顺序执行：

pnpm tsx scripts/backfill-origin-type.ts
pnpm tsx scripts/backfill-relayer.ts
pnpm tsx scripts/backfill-deposits.ts

⚠️ 注意事项

• 主同步脚本 pnpm fetch 默认扫描最近 3 天（约 129,600 区块）的链上日志。如需回填更早的历史数据，可通过 scanBlockRange(fromBlock, toBlock) 函数指定区块范围。
• 回填速度取决于所使用的 RPC 节点性能和速率限制。免费 RPC 可能较慢，推荐使用 Alchemy / Infura 等付费节点以获得更快的回填速度。

---

🗺️ Roadmap

✅ 已完成

• 市场数据自动同步 - Gamma API 自动同步 20,000+ 市场
• Smart Money 排行榜 - 链上交易分析与评分系统
• 钱包分析 - 输入任意地址查看历史持仓与 PnL
• 异常检测 - 价格波动、交易量异动自动识别
• AI 市场分析 - 输入事件 URL 获取 LLM 洞察
• 结算日历 - 可视化市场结算时间线

🔜 近期计划

• 跟单功能 - 订阅 Smart Money 地址，实时推送交易动态
• 市场预警通知 - 异常信号推送到 Telegram/Discord

🚀 中期计划

• 多平台聚合 - 接入 Kalshi、Opinion 等预测市场，统一数据视图
• 跨平台套利 - 识别不同平台间的赔率差异

🌐 远期愿景

• 链上跟单执行 - 连接钱包一键跟单 Smart Money 交易
• 策略回测 - 历史数据回测交易策略表现
• API 服务 - 开放 RESTful API 供第三方接入
• 社交预测插件 - 集成侧边栏插件，支持用户针对市场发表预测观点，基于预测准确率计算信誉分排名

---

🙏 鸣谢

感谢 OGBC 提供的学习文档支持。

感谢主办方 ETHPanda 和 LXDAO 提供的黑客松平台。

---

Made with ❤️ for the Polymarket Community