Opinion Whale Tracker：开源预测市场巨鲸监控与订单簿可视化工具

Opinion Whale Tracker 简介

Opinion Whale Tracker 是一款专注预测市场监控的开源工具，以结构清晰的 FastAPI 后端为核心，通过访问 Opinion CLOB API 聚合市场列表、订单簿与价格信息，提炼买卖墙数据并识别潜在巨鲸行为。前端以静态页面方式呈现，可在浏览器中直接查看市场概览、订单簿深度与大额委托情况。

项目保持极高安全性，不包含任何密钥或私人配置，用户需通过环境变量方式提供 OPINION_API_KEY。工具为个人 Web3 开发者打造，是记录灵感与探索数据可视化的一套轻量级监测方案，不承载任何投资建议。

技术架构与核心组件

后端（FastAPI + pydantic）

后端基于 FastAPI 构建，利用 pydantic 管理数据结构，性能稳定。项目使用 opinion_clob_sdk 访问 Opinion 的代理网关，实现：

• 市场分页聚合
• 订单簿数据拉取与买卖墙价值计算
• 巨鲸委托识别（默认阈值 500 USD，可自定义）
• 定时缓存刷新，减少上游 API 压力

主要后端入口文件为 backend/main.py。

前端结构

前端为 frontend/ 与 public/ 的静态页面，通过浏览器请求后端 API。
接口包含：

• / 健康检查
• /api/markets 市场列表与巨鲸监控结果
• /api/markets/{market_id} 单市场详情
• /api/whales?threshold= 按阈值筛选大额委托
• /api/orderbook/{token_id} 订单簿数据
• /api/stats 全局统计

可通过 cURL 或浏览器直接访问。

安装与运行指南

环境准备

python3 -m venv .venv  source .venv/bin/activate  pip install -r backend/requirements.txt  

环境变量设置

export OPINION_API_KEY="<your-key>"  

启动后端

python backend/main.py  # 或  uvicorn backend.main:app --host 0.0.0.0 --port 8000  

安全与合规设计

• 项目不保存任何密钥，.gitignore 已排除本地配置与敏感文件
• 若未配置 API Key，后端返回空数据，不抛出敏感信息
• 建议在 Vercel / Render / Railway 等平台以环境变量方式部署

可扩展性与开发提示

可扩展方向

• 添加更多数据源，丰富市场聚合逻辑
• 接入 Prometheus / Grafana，建立实时告警
• 将订单簿与巨鲸委托图形化展示

适用人群

• Web3 开发者
• 数据分析从业者
• 对市场结构、流动性与大额委托感兴趣的研究者
• 想要搭建交易数据可视化工具的个人开发者

项目开源地址：

GitHub：https://github.com/duolaAmengweb3/opinionWhale

在线体验：https://xmainstation.vercel.app/