NFTopia Analytics Service

The NFTopia Analytics Service is a Django-powered microservice that processes and visualizes platform analytics data. Running on port 9002, it provides actionable insights for NFT trading, user behavior, and market trends.

---

🔗 API Documentation

View Swagger Docs | Grafana Dashboard

---

✨ Analytics Features

• Real-time Data Processing:
  • 📊 NFT trading volume analytics
  • 👥 User engagement metrics
  • 📈 Market trend analysis
• Custom Reports:
  • Collection performance
  • Creator royalty tracking
  • Gas fee optimization insights
• Data Export: CSV/JSON endpoints for all datasets
• Anomaly Detection: AI-powered unusual activity alerts

---

🛠️ Tech Stack

Component	Technology
Framework	Django 4.2 + Django REST Framework
Database	PostgreSQL + TimescaleDB (for time-series)
Visualization	Grafana
Analytics Engine	Pandas + NumPy
Event Processing	Apache Kafka

---

🚀 Quick Start

Prerequisites

• Python 3.10+
• PostgreSQL 14+
• TimescaleDB extension
• Kafka broker

Installation

1. Clone the repo:

   git clone https://github.com/NFTopia-Foundation/nftopia-analytics-service.git
   cd nftopia-analytics-service

2. Setup virtual environment:

   python -m venv ven
   source venv/bin/activate  # Linux/Mac
   venv\Scripts\activate    # Windows

3. Install dependencies:

   pip install -r requirements.txt

4. Configure environment:

   cp .env.example .env

5. Run migrations:

   python manage.py migrate

6. Start the service:

   python manage.py runserver 9002

🤝 Contributing

1. Fork the repository
2. Create your feature branch:

git checkout -b feat/your-feature

3. Commit changes following Conventional Commits
4. Push to the branch
5. Open a Pull Request