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/