🔮 Real-Time BSC Token Scanner • 🐋 Whale Tracker • 📊 KOL Analytics

---

🏆 Performance & Quality Metrics

---

🌌 Overview

FlapScanner is a cutting-edge blockchain intelligence platform engineered for the BNB Smart Chain ecosystem. It aggregates data from multiple on-chain and off-chain sources into a unified, real-time dashboard — empowering traders and researchers with actionable insights.

"See the chain before the chain sees you."

🎯 Core Modules

🔮 FlapScanner v2.0
🔍 Scanner Real-time BSC token detection + security auditing	🐋 Whale Tracker Top 50 transactions by USD volume w/ address resolution	📊 KOL Analytics 7d / 30d / 90d performance rankings + win rates	📰 Feed Crypto news aggregator with live updates
🛡️ Security Engine — Batch Scan Token Security • Rugpull Detection • Phishing Protection
⚙️ FastAPI Backend Index Updater • GraphQL Bridge • Cache Layer

🏗️ Architecture

graph TD
    A["👤 User"] --> B["Next.js 15 Frontend"]
    B --> C{"API Layer"}
    C --> D["api/trending"]
    C --> E["api/whale"]
    C --> F["api/kol"]
    C --> G["api/token-profiles"]
    C --> H["api/batch-scan"]
    C --> I["api/search"]
    C --> J["api/news"]

    D --> K["FastAPI Backend"]
    G --> K
    H --> K

    K --> L[("Index Cache")]
    K --> M["Security Auditor"]

    E --> N["Whale Data Source"]
    F --> O["KOL Analytics Source"]
    J --> P["News Aggregator"]

    style A fill:#6C3CE1,color:#fff
    style B fill:#0070F3,color:#fff
    style K fill:#009688,color:#fff
    style M fill:#EF4444,color:#fff

Loading

⚡ Tech Stack

Layer	Technology	Purpose
Frontend		SSR + App Router
Language		Type-safe codebase
Styling		Utility-first + Radix
Backend		High-perf API server
Data		Multi-source aggregation
Infra		Edge + VPS deployment

🚀 Quick Start

# Clone the repository
git clone https://github.com/your-org/flap-scanner.git
cd flap-scanner

# Install frontend dependencies
pnpm install

# Setup environment
cp .env.example .env

# Start the backend
cd backend && pip install -r requirements.txt
uvicorn main:app --port 8001 --reload &

# Start the frontend
cd .. && pnpm dev

🌐 Open http://localhost:3000 to view the dashboard.

📁 Project Structure

flap-scanner/
├── app/                    # Next.js 15 App Router
│   ├── api/                # API proxy routes (9 endpoints)
│   │   ├── trending/       # Live token feed
│   │   ├── whale/          # Whale movement tracker
│   │   ├── kol/            # KOL performance rankings
│   │   ├── token-profiles/ # Token enrichment
│   │   ├── batch-scan/     # Multi-source security scan
│   │   ├── search/         # Pair search
│   │   ├── news/           # News aggregator
│   │   ├── worst/          # Worst performer data
│   │   └── pairs/          # Dynamic pair lookup
│   ├── whale/              # Whale tracking page
│   ├── kol/                # KOL rankings page
│   ├── feed/               # News feed page
│   ├── about/              # About page
│   └── token/              # Token detail pages
├── backend/                # FastAPI Python backend
│   └── main.py             # API server with caching
├── components/             # React components
│   ├── ui/                 # shadcn/ui primitives (50+)
│   ├── coin-list.tsx       # Main scanner table
│   ├── whale-list.tsx      # Whale transactions
│   ├── kol-list.tsx        # KOL rankings
│   └── ...                 # 15+ custom components
├── hooks/                  # Custom React hooks
├── lib/                    # Utilities & API clients
│   ├── i18n/               # Internationalization (EN/ZH)
│   └── types.ts            # Shared TypeScript types
└── styles/                 # Global stylesheets

🔐 Security Features

Token Security Audit ✅ Contract verification ✅ Honeypot detection ✅ Tax analysis (buy/sell) ✅ Ownership check ✅ Liquidity lock status

Rugpull Detection ✅ Creator wallet analysis ✅ LP token distribution ✅ Contract risk scoring ✅ Historical pattern matching ✅ Real-time alerts

Phishing Protection ✅ URL reputation check ✅ Domain age verification ✅ SSL certificate audit ✅ Known scam database ✅ Community reports

🌍 Internationalization

FlapScanner ships with built-in multi-language support:

Language	Status	Coverage
🇺🇸 English	✅ Complete	100%
🇨🇳 中文	✅ Complete	100%

📊 API Endpoints

Method	Endpoint	Description	Cache
GET	/api/trending	Live trending tokens feed	3min
GET	/api/token-profiles	Enriched token profiles (1000)	3min
GET	/api/whale	Top 50 whale transactions	None
GET	/api/kol?duration=7d	KOL performance rankings	None
GET	/api/search?q=TOKEN	Pair search	1min
GET	/api/news?page=1	Crypto news feed	5min
GET	/api/pairs/:chain/:pair	Specific pair data	2min
GET/POST	/api/batch-scan	Multi-source security scan	None
GET	/api/worst	Worst performers	None

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

---

Built with 💜 by the FlapScanner Team

_{© 2025-2026 FlapScanner. All rights reserved. Proprietary and confidential.}