PolyScan - Polymarket Whale Tracking SaaS Application
Premium Prediction Market Intelligence Platform
Description
PolyScan - Polymarket Whale Tracking SaaS Application
Premium Prediction Market Intelligence Platform | Whale Tracker | Crypto Trading Signals | Real-Time Alerts
Product Overview
PolyScan is a complete, production-ready SaaS application for tracking whale traders on Polymarket - the world's largest prediction market. This turnkey solution enables you to launch your own whale tracking platform with subscription monetization, real-time alerts, AI-powered analysis, and multi-channel notifications.
Deploy your own prediction market intelligence platform and start generating recurring revenue from traders who want to follow smart money movements.
What You Get
- Complete Source Code - Full Next.js 16 application with TypeScript
- Admin Dashboard - Manage users, subscriptions, whales, and settings
- User Dashboard - Beautiful, responsive interface for tracking whales
- 3-Tier Subscription System - FREE, PRO ($29/mo), WHALE ($99/mo) plans
- Payment Integration - Stripe integration for recurring payments
- Multi-Channel Alerts - Email, Telegram, Twitter/X, Push Notifications
- AI Analysis - Grok AI integration for market predictions
- Web3 Authentication - Sign In With Ethereum (SIWE) + Traditional Auth
- Database Schema - Complete PostgreSQL database with 30+ models
- Background Workers - Automated whale discovery and trade tracking
- Deployment Guide - Step-by-step production deployment instructions
Key Features
Real-Time Whale Tracking
- Automatic discovery of all Polymarket whales ($100K+ portfolios)
- 10-second polling interval for trade detection
- Portfolio snapshots every 5 minutes
- PnL tracking: 1h, 6h, 24h, 7d, 30d changes
- Historical trade data with before/after portfolio states
Trader Tier Classification
| Tier | Portfolio Size | Icon |
|---|---|---|
| Whale | $1M+ | Blue Whale |
| Shark | $100K - $1M | Shark |
| Dolphin | < $100K | Dolphin |
Big Bet Alerts
- Configurable minimum trade thresholds
- Real-time notifications across all channels
- Telegram: Instant alerts to your channel
- Twitter/X: Automated whale trade posts (rate-limited)
- Email: HTML-formatted alert emails
- Push: Browser push notifications
Market Intelligence
- Live market prices, volume, and liquidity data
- Order book depth and spread analysis
- Top holders per market outcome
- Market snapshots with money flow indicators
- Fear & Greed gauge visualization
AI-Powered Analysis (Grok AI)
- Market prediction with confidence scores
- Trading pattern recognition
- Whale strategy identification
- Mispriced market detection
- Factor analysis: sentiment, news, momentum
User Features
- Follow specific whales and traders
- Custom price alerts (above/below thresholds)
- Personal prediction tracking
- Portfolio monitoring
- Customizable notification preferences
- Dark/Light theme support
Leaderboards & Rankings
- PnL rankings (daily, weekly, monthly, all-time)
- Volume rankings
- Win rate statistics
- Positions count rankings
- Filterable and sortable
Admin Dashboard
- User management with subscription controls
- Whale database management
- Market data administration
- Site settings configuration
- Sync status monitoring
- System statistics overview
Tech Stack
Frontend
| Technology | Version | Purpose |
|---|---|---|
| Next.js | 16.1.1 | React framework with App Router |
| React | 19.2.3 | UI library |
| TypeScript | 5.x | Type safety |
| Tailwind CSS | 4.x | Styling |
| Radix UI | Latest | Accessible UI components |
| Recharts | 2.15.4 | Data visualization |
| Zustand | 5.0.9 | State management |
| TanStack Query | 5.90.12 | Data fetching |
| RainbowKit | 2.2.10 | Web3 wallet connection |
Backend
| Technology | Version | Purpose |
|---|---|---|
| Node.js | 20.x | Runtime |
| Next.js API Routes | 16.x | Serverless API |
| Prisma | 5.22.0 | Database ORM |
| NextAuth.js | 4.24.13 | Authentication |
| PostgreSQL | 14+ | Database |
| PM2 | Latest | Process management |
Integrations
| Service | Purpose |
|---|---|
| Polymarket APIs | Market data, trades, positions |
| Stripe | Payment processing |
| Telegram Bot API | Instant alerts |
| Twitter/X API | Social posting |
| Grok AI (X.AI) | Market analysis |
| WalletConnect | Web3 authentication |
| Nodemailer | Email delivery |
Subscription Tiers
FREE
- Basic whale tracking
- Public leaderboard access
- Limited market data
- No alerts
PRO - $29/month
- Real-time trade alerts
- Follow unlimited whales
- Email notifications
- Telegram integration
- Market analytics
- Priority support
WHALE - $99/month
- All PRO features
- AI-powered predictions
- Custom alert thresholds
- API access
- Advanced analytics
- Priority whale discovery
- White-glove onboarding
System Requirements
Production Server
- OS: Ubuntu 22.04/24.04 LTS (recommended) or any Linux
- CPU: 2+ vCPU cores
- RAM: 4GB minimum, 8GB recommended
- Storage: 40GB+ SSD
- Node.js: v20.x or higher
- PostgreSQL: 14+
Development
- Node.js: v20.x or higher
- npm: v10.x or higher
- PostgreSQL: 14+ (local or remote)
- Any OS: Windows, macOS, or Linux
External Services (Required)
| Service | Purpose | Cost |
|---|---|---|
| PostgreSQL Database | Data storage | Free - $50/mo |
| SMTP Provider | Email delivery | Free - $20/mo |
| Domain + SSL | HTTPS hosting | ~$15/year |
External Services (Optional)
| Service | Purpose | Cost |
|---|---|---|
| Stripe Account | Payments | 2.9% + $0.30/tx |
| Telegram Bot | Alerts | Free |
| Twitter/X Developer | Social posting | Free - $100/mo |
| Grok AI API | AI analysis | Pay per use |
| WalletConnect | Web3 auth | Free tier available |
Architecture Overview
┌─────────────────────────────────────────────────────────────────┐
│ FRONTEND │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────────────────┐ │
│ │ Landing │ │ Dashboard │ │ Admin Panel │ │
│ │ Page │ │ (User) │ │ (User/Whale/Market) │ │
│ └─────────────┘ └─────────────┘ └─────────────────────────┘ │
└─────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ NEXT.JS API ROUTES │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌───────────────┐ │
│ │ Auth │ │ Markets │ │ Whales │ │ Stripe │ │
│ │ Routes │ │ Routes │ │ Routes │ │ Webhooks │ │
│ └──────────┘ └──────────┘ └──────────┘ └───────────────┘ │
└─────────────────────────────────────────────────────────────────┘
│
┌────────────────────┼────────────────────┐
▼ ▼ ▼
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────────┐
│ PostgreSQL │ │ Background │ │ External APIs │
│ Database │ │ Workers (PM2) │ │ │
│ │ │ │ │ • Polymarket │
│ • Users │ │ • Whale Sync │ │ • Stripe │
│ • Whales │ │ • Market Sync │ │ • Telegram │
│ • Markets │ │ • Trade Sync │ │ • Twitter/X │
│ • Trades │ │ • Alerts │ │ • Grok AI │
│ • Subscriptions│ │ │ │ • Blockchain │
└─────────────────┘ └─────────────────┘ └─────────────────────┘
Database Schema
The application includes 30+ database models covering:
Core Entities
- Users - Authentication, profiles, subscriptions
- Whales - Trader profiles with stats (PnL, volume, win rate)
- Markets - Polymarket data (prices, volume, liquidity)
- Trades - Complete trade history with portfolio snapshots
Tracking & Analytics
- WhalePosition - Current positions held by whales
- WhaleActivity - Trade activity log
- WhalePnlHistory - Daily PnL tracking
- WhalePortfolioSnapshot - 5-minute portfolio snapshots
- MarketSnapshot - Market state over time
- PriceHistory - Historical price data
User Features
- WhaleFollow - User whale subscriptions
- Alert - Custom user alerts
- Notification - In-app notifications
- PushSubscription - Web push subscriptions
Monetization
- Subscription - User subscription records
- ApiKey - User API keys for programmatic access
API Endpoints
Authentication (8 endpoints)
- User registration with email verification
- Sign In With Ethereum (SIWE)
- OAuth providers (Google, etc.)
- Session management
Markets (10+ endpoints)
- List markets with filtering/sorting
- Market details and analytics
- Price history and order books
- Top holders per outcome
Whales (8+ endpoints)
- Whale list with rankings
- Individual whale profiles
- Trade history
- Position tracking
Admin (15+ endpoints)
- User management
- Subscription management
- Whale database management
- Site settings
- System statistics
Notifications (5+ endpoints)
- Alert configuration
- Push subscription management
- Real-time notification stream (SSE)
Included Integrations
Telegram Bot
Automatically posts whale trades to your Telegram channel:
- Customizable trade threshold ($30K default)
- Rich HTML formatting with emojis
- Direct links to whale profiles
- Buy/Sell indicators
Twitter/X Auto-Posting
Automatically tweets significant whale trades:
- Rate-limited (1 tweet per 2 hours)
- $100K+ trade threshold
- Formatted with whale info and market details
- Helps drive organic traffic to your platform
Stripe Payments
Complete payment integration:
- Checkout sessions for subscriptions
- Customer billing portal
- Webhook handling for events
- Subscription lifecycle management
Grok AI Analysis
AI-powered market intelligence:
- Prediction confidence scores
- Factor analysis
- Whale pattern recognition
- Market efficiency detection
File Structure
/
├── src/
│ ├── app/ # Next.js App Router pages
│ │ ├── (auth)/ # Auth pages (login, register)
│ │ ├── (dashboard)/ # User dashboard pages
│ │ ├── admin/ # Admin panel pages
│ │ └── api/ # API route handlers
│ ├── components/ # React components
│ │ ├── ui/ # Radix UI components
│ │ └── layout/ # Layout components
│ ├── lib/ # Shared utilities
│ │ ├── auth/ # Authentication config
│ │ ├── polymarket/ # Polymarket API client
│ │ ├── notifications/ # Notification handlers
│ │ ├── stripe/ # Stripe integration
│ │ └── grok/ # AI client
│ └── types/ # TypeScript definitions
├── prisma/
│ ├── schema.prisma # Database schema
│ └── seed.ts # Database seeding
├── scripts/
│ └── whale-sync-cron.ts # Background sync worker
├── public/ # Static assets
├── ecosystem.config.js # PM2 configuration
└── deploy.md # Deployment guide
Production Deployment
Detailed deployment guide included for:
- Ubuntu VPS with Nginx reverse proxy
- PM2 process management
- Let's Encrypt SSL certificates
- PostgreSQL database setup
- Systemd service configuration
Customization Options
Branding
- Logo and favicon in
/public - Color scheme via Tailwind CSS config
- Site name and meta tags in layout files
Pricing
- Subscription tiers configurable in admin panel
- Stripe price IDs in environment variables
- Feature gates per tier in code
Thresholds
- Minimum whale portfolio: Configurable
- Alert thresholds: Per-user configurable
- Tweet threshold: Environment variable
- Telegram threshold: Environment variable
Features
- Enable/disable AI analysis
- Enable/disable specific notification channels
- Enable/disable Web3 authentication
- Enable/disable specific subscription tiers
License & Usage
This is a source code license for:
- Single domain deployment
- Unlimited users on your platform
- Full customization rights
- No resale of source code
Not included:
- Ongoing support (available separately)
- Hosting or infrastructure
- Third-party API costs
Revenue Potential
Example Monthly Revenue
| Metric | Conservative | Moderate | Aggressive |
|---|---|---|---|
| PRO Subscribers | 50 | 200 | 500 |
| WHALE Subscribers | 10 | 50 | 150 |
| PRO Revenue | $1,450 | $5,800 | $14,500 |
| WHALE Revenue | $990 | $4,950 | $14,850 |
| Total MRR | $2,440 | $10,750 | $29,350 |
Frequently Asked Questions
Q: Do I need coding experience? A: Basic familiarity with Node.js and command line is helpful. Detailed setup instructions are included.
Q: What ongoing costs should I expect? A: VPS hosting ($10-50/mo), domain (~$15/yr), optional: Stripe fees (2.9% per transaction), Twitter API ($100/mo for premium), email service ($0-20/mo).
Q: Can I modify the code? A: Yes, full source code is provided. Customize branding, features, pricing, and more.
Q: Is support included? A: Basic documentation is included. Extended support packages available separately.
Q: How often is Polymarket data updated? A: Whale trades are detected within 10 seconds. Market data refreshes every minute.
Q: Can I use this for other prediction markets? A: The codebase is built for Polymarket but can be adapted for other platforms with development work.
What's Next After Purchase
- Download the zip file
- Extract to your development environment
- Configure environment variables
- Deploy to your VPS or cloud provider
- Customize branding and pricing
- Launch and start acquiring users
- Monetize with subscription revenue
Technical Support
- Comprehensive documentation included
- Deployment guide with step-by-step instructions
- Database schema documentation
- API endpoint documentation
PolyScan - Your complete solution for launching a Polymarket whale tracking SaaS platform.
Built with modern technologies. Ready for production. Start earning recurring revenue today.
Disclaimer: Web3.Market is a marketplace platform that facilitates the sale of digital products between independent sellers and buyers. We do not develop, endorse, or guarantee any product listed on this platform. All products are provided by third-party sellers and are sold "as is." Web3.Market assumes no responsibility or liability for the functionality, security, legality, or any use or misuse of products purchased through this platform. Buyers are solely responsible for evaluating the suitability of any product for their intended purpose and for ensuring compliance with all applicable laws and regulations. By purchasing, you acknowledge that Web3.Market shall not be held liable for any direct, indirect, incidental, or consequential damages arising from the use of any product.
One-time payment • Lifetime access
Product Info
RPC Providers
Need a reliable RPC endpoint for your dApp? Get started with these trusted providers:
