Opinion Whale Tracker 简介
Opinion Whale Tracker 是一款专为预测市场设计的开源监控工具。该工具通过 FastAPI 构建高性能后端，调用 Opinion CLOB API 实时聚合市场列表、订单簿及价格信息，旨在通过分析买卖墙数据来精准识别“巨鲸”的资金动向。
前端采用轻量化的静态页面设计，用户无需复杂安装即可在浏览器中直观查看市场概览、订单簿深度及大额委托详情。本项目定位为 Web3 开发者的灵感记录与数据可视化方案，仅供技术探索，不构成任何投资建议。
技术架构分析
后端逻辑 (FastAPI + Pydantic)
后端核心位于 backend/main.py，利用 Pydantic 确保数据结构的严谨性。通过集成 opinion_clob_sdk 访问代理网关，实现以下核心功能：
- 数据聚合： 支持市场分页请求，高效拉取订单簿数据。
- 价值计算： 自动计算买卖墙的总价值，量化市场支撑与压力。
- 巨鲸识别： 监测大额委托（默认阈值为 500 USD，支持自定义）。
- 性能优化： 引入定时缓存机制，有效降低对上游 API 的请求压力。
前端接口
前端由 frontend/ 与 public/ 目录下的静态页面组成，通过以下 API 接口与后端交互：
/：服务健康状态检查/api/markets：获取市场列表及巨鲸监控汇总/api/markets/{market_id}：查询特定市场的详细数据/api/whales?threshold=：基于自定义阈值筛选大额委托/api/orderbook/{token_id}：获取指定 Token 的订单簿深度/api/stats：获取全局统计指标
部署与运行步骤
- 配置 Python 环境：
python3 -m venv .venv source .venv/bin/activate pip install -r backend/requirements.txt - 注入 API 密钥：
本项目不存储任何私密配置，请通过环境变量提供 Key：
export OPINION_API_KEY="<your-key>" - 启动服务：
# 方式一：直接运行脚本 python backend/main.py # 方式二：使用 uvicorn 启动 uvicorn backend.main:app --host 0.0.0.0 --port 8000
安全与扩展指南
安全设计
- 零密钥存储：
.gitignore已严格排除本地配置文件，确保敏感信息不被提交。 - 异常处理： 若未检测到 API Key，后端将返回空数据集而非抛出敏感错误信息。
- 部署建议： 推荐使用 Vercel、Render 或 Railway 等平台，通过其内置的环境变量管理功能进行部署。
开发扩展方向
- 数据增强： 接入更多第三方数据源，优化市场聚合逻辑。
- 实时告警： 结合 Prometheus 与 Grafana 构建巨鲸异动实时推送系统。
- 可视化升级： 将枯燥的订单簿数据转化为动态的深度图或热力图。
适用场景
本工具非常适合以下人群使用：
- 希望研究预测市场流动性与大额委托分布的 研究员。
- 寻找轻量级交易数据可视化方案的 个人开发者。
- 专注于 Web3 数据分析与监控工具构建的 工程师。
项目资源：
正文完
