Ronin Ecosystem Tracker

A comprehensive, production-grade analytics platform for the Ronin blockchain gaming economy. This project provides real-time insights into gaming performance, DeFi activity, NFT marketplace dynamics, and network health monitoring through multiple interfaces: a modern web dashboard, a Streamlit analytics app, and a robust FastAPI backend.

🌐 Live Applications

Primary App/Dashboard (Next.js): https://www.ronhub.io/analytics
API Backend: Hosted on Railway

📊 Project Overview

This platform aggregates and visualizes data from 13 different data sources (1 CoinGecko + 12 Dune Analytics queries) to provide a holistic view of the Ronin Network ecosystem. The architecture consists of three main components:

FastAPI Backend - Raw data pass-through with 24-hour intelligent caching
Next.js Frontend - Modern, interactive web dashboard with real-time updates
Streamlit App - Professional analytics interface with advanced visualizations

✨ Core Features

Analytics Capabilities

Gaming Intelligence: Player behavior analysis, game performance rankings, revenue optimization
DeFi Analytics: Liquidity flow analysis, trading patterns, whale activity monitoring
NFT Marketplace Intel: Collection performance metrics, floor price analytics, revenue breakdown
Network Health Monitoring: Real-time performance scoring, congestion analysis, predictive alerts
Token Holder Analytics: Distribution analysis, segmentation (whales, large holders, retail)
User Retention Analysis: Cohort-based retention tracking with interactive heatmaps

Technical Features

24-hour intelligent caching system for optimal API usage
Real-time alert system with severity levels
Actionable recommendations and insights
Interactive charts and visualizations (Plotly, Recharts)
Dark/light mode with persistent preferences
Responsive design for all devices
Auto-refresh capabilities with manual override
Time-based filtering (7, 30, 90 days, all time)

🏗️ Architecture

System Design

┌─────────────────┐     ┌──────────────────┐     ┌─────────────────┐
│  External APIs  │────▶│  FastAPI Backend │────▶│  Application   │
│                 │     │  (Railway)       │     │                 │
│ • Dune (x12)    │     │                  │     │ • Next.js Web   │
│ • CoinGecko     │     │ • 24hr Cache     │     │                 │
└─────────────────┘     │ • Rate Limiting  │     └─────────────────┘
                        │ • Data Proxy     │
                        └──────────────────┘

Data Flow

External APIs → FastAPI fetches from Dune Analytics & CoinGecko
Caching Layer → 24-hour cache with joblib for persistent storage
API Endpoints → RESTful endpoints serve raw, unmanipulated data
Frontend App → Next.js consume API data
User Interface → Interactive visualizations and real-time updates

📡 API Documentation

Base URL

Production: https://web-production-4fae.up.railway.app

Key Endpoints

CoinGecko Data

GET /api/raw/coingecko/ron - RON token market data

Dune Analytics Data (12 endpoints)

GET /api/raw/dune/ronindailyactivity - Daily network metrics
GET /api/raw/dune/gamesoverallactivity - Gaming statistics
GET /api/raw/dune/gamesdailyactivity - Daily gaming activity
GET /api/raw/dune/useractivationretention - User retention cohorts
GET /api/raw/dune/roncurrentholders - Token holder data
GET /api/raw/dune/ronsegmentedholders - Holder segmentation
GET /api/raw/dune/wronactivetrade_pairs - DEX trading pairs
GET /api/raw/dune/wronwhaletracking - Whale wallet activity
GET /api/raw/dune/wronvolumeliquidity - Volume & liquidity
GET /api/raw/dune/wrontradinghourly - Hourly trading patterns
GET /api/raw/dune/wronweeklysegmentation - Weekly trader segments
GET /api/raw/dune/nft_collections - NFT marketplace data

Utility Endpoints

GET /api/cache/status - Cache status for all sources
POST /api/cache/refresh - Force refresh all data
POST /api/cache/clear - Clear all cached data
GET /api/bulk/all - Get all data sources at once

🛠️ Technology Stack

Backend (FastAPI)

Framework: FastAPI
Data Processing: Pandas, NumPy
Caching: Joblib (24-hour persistent cache)
APIs: Dune Analytics, CoinGecko Pro
Async Operations: aiohttp, asyncio
Deployment: Railway

Frontend (Next.js)

Framework: Next.js 15 with App Router
UI Library: React 19, TypeScript
Styling: Tailwind CSS v4, shadcn/ui
Charts: Recharts
Data Fetching: SWR (stale-while-revalidate)
Icons: Lucide React
Deployment: Vercel

📁 Project Structure

ronin-ecosystem-tracker/
├── main.py                      # FastAPI backend application
├── ronintrackerapp.py         # Streamlit analytics app
├── requirements.txt             # Python dependencies
├── .env                         # Environment variables (create locally)
├── rawdatacache/             # Cache directory (auto-created)
├── frontend/                    # Next.js application
│  ├── app/
│  │   ├── api/                    # Next.js API routes (proxy layer)
│  │   │   ├── coingecko/
│  │   │   │   └── ron/
│  │   │   │       └── route.ts    # RON token data endpoint
│  │   │   └── dune/
│  │   │       ├── games-overall/
│  │   │       ├── games-daily/
│  │   │       ├── ronin-daily/
│  │   │       ├── retention/
│  │   │       ├── holders/
│  │   │       ├── segmented-holders/
│  │   │       ├── trade-pairs/
│  │   │       ├── whales/
│  │   │       ├── volume-liquidity/
│  │   │       ├── hourly/
│  │   │       ├── weekly-segmentation/
│  │   │       └── nft-collections/
│  │   ├── layout.tsx              # Root layout with theme provider
│  │   ├── page.tsx                # Main dashboard page
│  │   └── globals.css             # Global styles and design tokens
│  ├── components/
│  │   ├── ui/                     # shadcn/ui components
│  │   ├── animated-background.tsx # Particle animation system
│  │   ├── gaming-economy.tsx      # Gaming metrics section
│  │   ├── header.tsx              # Dashboard header with refresh
│  │   ├── hero-section.tsx        # RON token overview
│  │   ├── katana-dex.tsx          # DEX analytics section
│  │   ├── network-activity.tsx    # Network activity charts
│  │   ├── network-health.tsx      # Network health metrics
│  │   ├── nft-collections.tsx     # NFT collections table
│  │   ├── nft-marketplace.tsx     # NFT marketplace section
│  │   ├── retention-heatmap.tsx   # Cohort retention heatmap
│  │   ├── theme-provider.tsx      # Dark/light mode provider
│  │   ├── theme-toggle.tsx        # Theme switcher button
│  │   ├── token-holders.tsx       # Token holder analytics
│  │   └── token-metrics.tsx       # Token metrics cards
│  ├── hooks/
│  │   ├── use-mobile.tsx          # Mobile detection hook
│  │   └── use-toast.ts            # Toast notification hook
│  ├── lib/
│  │   └── utils.ts                # Utility functions (cn, etc.)
│  └── public/                     # Static assets
├── Notebooks/                   # Jupyter notebooks for analysis
└── README.md                   # This file