SupaScan Overview

SupaScan is the most advanced data analytics platform for the Solana network, providing real-time access to indexed blockchain data through multiple APIs, specialized analytical tools (SupaApps), and comprehensive monitoring capabilities. This guide provides a complete overview of SupaScan's features, architecture, and capabilities.

What is SupaScan?

SupaScan is an infrastructure product that provides real-time access to Solana blockchain data in a convenient, indexed, and understandable format. It collects, processes, and structures all significant blockchain events: from transactions and contract interactions to token activity, wallet behavior, meme tokens, and even Twitter influencer activity.

Core Value Proposition

SupaScan is like "Solana blockchain data translated into human language" - it highlights patterns, shows regularities, and enables hypothesis building, trend discovery, and profit generation through advanced analytics.

SupaScan Architecture

SupaScan is built on a modular architecture where each component handles a specific level of analysis:

Core Components

  • ClickHouse Database: Ultra-fast analytical database for real-time queries
  • Solana Parsers: Break down block and transaction events
  • Indexing Engine: Constantly updates the database state
  • SupaApps Suite: Specialized analytical tools
  • Realtime Trackers: Compare index with Solana L1
  • Multi-API Layer: REST, SQL, GraphQL, WebSocket, and Webhook APIs

Key Design Principles

  • Real-time Processing: < 5 seconds lag behind Solana L1
  • Horizontal Scalability: Scale by adding more nodes
  • Data Consistency: Ensure data integrity across the system
  • High Availability: Design for maximum uptime and fault tolerance

What SupaScan Indexes

SupaScan provides comprehensive indexing of all significant Solana blockchain events:

Transaction Data

  • Transaction type, program, status, fees
  • Recipient/sender information
  • Instruction details and logs
  • Compute units consumed

Token Analytics

  • Pool information and swap data
  • Liquidity tracking and activity
  • Token "resurrections" and price movements
  • Supply and metadata information

Wallet Profiling

  • Behavior patterns and trading history
  • Win rate and ROI calculations
  • Connection analysis and activity profiles
  • Smart money identification

Protocol Integration

  • DEX Protocols: Meteora, Jupiter, Solayer, BonkBot, Raydium
  • Farming/Airdrops: Farmer patterns, volumes, dynamics
  • Social Signals: Twitter influencers, posts, engagement, price correlation

Infrastructure Monitoring

  • Slot synchronization and block processing
  • RPC node health and performance
  • Network congestion and ping analysis

SupaApps - Specialized Analytical Tools

SupaScan includes a suite of specialized applications for different analytical needs:

Wallet Profiler

Complete portrait of any wallet address with trading patterns, performance metrics, and behavior analysis.

KOL Watch

Track actions of influencers and "smart money" wallets with real-time monitoring and alert systems.

PnL Detective

Analyze profit and loss patterns of traders with detailed performance metrics and risk assessment.

Rebirth Monitor

Track tokens that suddenly "come alive" with unusual activity patterns and volume spikes.

Farmer Classifier

Identify airdrop farmers by analyzing patterns and behavior characteristics.

Ape Detector

Identify early adopters of meme tokens and new project launches.

Twitter → Chain

Connect social media posts with on-chain activity to analyze influencer impact.

API Access Methods

SupaScan provides multiple ways to access blockchain data:

REST API

Standard HTTP endpoints for data access with comprehensive authentication and rate limiting.

# Get transaction details
curl -H "Authorization: Bearer $SUPASCAN_API_KEY" \
  "https://api.supascan.com/v1/transactions/5KJp7K8XQ2w3e4r5t6y7u8i9o0p1a2s3d4f5g6h7j8k9l0z1x2c3v4b5n6m7"

# Get wallet transactions
curl -H "Authorization: Bearer $SUPASCAN_API_KEY" \
  "https://api.supascan.com/v1/wallets/Deployer1234567890abcdef1234567890abcdef123456/transactions"

SQL API (ClickHouse Direct Access)

Direct access to ClickHouse for advanced queries and custom analytics.

-- Most liquid tokens (24h)
SELECT 
    token_mint,
    token_symbol,
    SUM(volume_usd) as total_volume
FROM token_swaps 
WHERE timestamp >= now() - INTERVAL 24 HOUR
GROUP BY token_mint, token_symbol
ORDER BY total_volume DESC
LIMIT 10;

WebSocket API

Real-time data streaming for live updates and monitoring.

const ws = new WebSocket('wss://api.supascan.com/v1/stream');
ws.onmessage = (event) => {
  const data = JSON.parse(event.data);
  console.log('New transaction:', data);
};

GraphQL API

Flexible data querying with custom field selection.

query GetTokenData($mint: String!) {
  token(mint: $mint) {
    name
    symbol
    supply
    metadata {
      description
      image
    }
    transfers(first: 10) {
      from
      to
      amount
      timestamp
    }
  }
}

Webhook API

Event-driven notifications for specific blockchain events.

# Set up token creation alerts
curl -X POST \
  -H "Authorization: Bearer $SUPASCAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "webhook_url": "https://your-app.com/webhook",
    "filters": {
      "token_name_contains": ["PEPE", "DOGE", "SHIB"],
      "min_initial_supply": 1000000000,
      "min_liquidity_usd": 10000
    }
  }' \
  https://api.supascan.com/v1/webhooks/token-alerts

Notification System

SupaScan provides comprehensive notification capabilities across multiple channels:

Notification Channels

  • Discord: Rich embeds with color coding and role mentions
  • Telegram: Markdown formatting with inline keyboards
  • AI Agents: Structured JSON with evaluation data and action triggers
  • Custom Webhooks: Flexible payload formats for any application

Event Types

  • Token Creation: New token launches with liquidity and social signal analysis
  • Large Transactions: Significant movements with wallet profiling
  • DEX Swaps: Trading patterns and smart money tracking
  • Social Signals: Twitter influencer activity with on-chain correlation

AI Agent Integration

Configure AI agents to receive notifications and perform automated actions:

const handleNotification = async (notification) => {
  const { event_type, data, evaluation_score } = notification;
  
  if (event_type === 'token_creation' && evaluation_score > 0.8) {
    await analyzeToken(data.token);
    await checkDeployerHistory(data.token.deployer);
    await monitorLiquidity(data.liquidity);
  }
};

Database Architecture

ClickHouse Cluster

SupaScan uses ClickHouse as the primary analytical database with:

  • ReplicatedMergeTree Engine: For data consistency and fault tolerance
  • Partitioning: By date for optimal query performance
  • Compression: LZ4HC and ZSTD for efficient storage
  • Materialized Views: Pre-aggregated data for faster analytics
  • Sparse Indexes: Bloom filter and MinMax indexes for optimized queries

Data Sources

  • RPC Nodes: Primary, fallback, and archival nodes for comprehensive coverage
  • Custom Indexing: Proprietary parsing and extraction logic
  • Real-time Sync: < 5 seconds lag behind Solana L1

Performance Optimizations

  • Batch Processing: Optimized data ingestion in chunks
  • Connection Pooling: Efficient database connection management
  • Query Optimization: Indexed queries and materialized views
  • Caching Strategy: Multi-level caching (L1, L2, L3)

Deployment Options

Self-Hosted Installation

Deploy SupaScan on your own infrastructure with full control and customization:

System Requirements

  • Node.js: v18+ with TypeScript support
  • ClickHouse: Cluster setup with replication
  • Redis: For caching and session management
  • RAM: 16GB+ recommended
  • Storage: SSD with 1TB+ for data
  • CPU: 8+ cores for optimal performance

Installation Steps

# Clone SupaScan self-hosted repository
git clone https://github.com/supascan/supascan-selfhosted.git
cd supascan-selfhosted

# Install dependencies
npm install

# Configure environment variables
cp .env.example .env
# Edit .env with your configuration

# Set up ClickHouse cluster
./scripts/setup-clickhouse.sh

# Set up Redis
./scripts/setup-redis.sh

# Start services
docker-compose up -d

Deployment Methods

  • Docker Compose: Recommended for easy deployment
  • PM2: Node.js process management
  • Kubernetes: For large-scale deployments
  • Cloud Platforms: AWS, GCP, Azure support

Security & Compliance

Data Security

  • Encryption: All data encrypted in transit and at rest
  • HTTPS: Mandatory SSL/TLS for all API communications
  • API Keys: Secure authentication with rate limiting
  • Data Isolation: User data isolated by design
  • Audit Logging: Complete audit trail of all operations

Compliance

  • SOC 2: Compliance with security standards
  • Data Privacy: GDPR-compliant data handling
  • Access Control: Role-based access control (RBAC)
  • Monitoring: 24/7 security monitoring and alerting

Pricing & Support

Pricing Tiers

  • Free Tier: 5,000 requests/day, basic endpoints
  • Pro Tier: 100,000 requests/day, all endpoints + webhooks
  • Enterprise: Unlimited requests, custom infrastructure, dedicated support

Support Channels

  • 24/7 Support: Email, Discord, GitHub, Telegram
  • Documentation: Comprehensive guides and API references
  • Community: Active developer community and forums
  • Enterprise Support: Dedicated support for enterprise customers

Use Cases & Applications

For Traders & Investors

  • Early Token Detection: Get alerts for new token launches with high potential
  • Smart Money Tracking: Follow successful traders and copy their strategies
  • Market Analysis: Access comprehensive DEX data and trading patterns
  • Risk Management: Identify scam tokens and risky investments

For Teams & Projects

  • User Behavior Analysis: Understand how users interact with your project
  • Competitor Monitoring: Track competitor activity and market positioning
  • Community Analytics: Analyze social signals and community engagement
  • Performance Metrics: Monitor project health and growth indicators

For Developers & Integrators

  • API Integration: Build applications with comprehensive blockchain data
  • Custom Analytics: Create specialized tools using SupaApps
  • Real-time Data: Access live blockchain events through WebSocket and Webhook APIs
  • Historical Analysis: Query years of indexed blockchain data

For Researchers & Analysts

  • Market Research: Analyze trends and patterns in the Solana ecosystem
  • Academic Studies: Access structured data for blockchain research
  • DeFi Analytics: Study decentralized finance protocols and their usage
  • Social Impact: Correlate social media activity with on-chain behavior

Getting Started

Quick Start

  1. Get API Key: Visit @SupaScanBot on Telegram
  2. Choose Plan: Start with Free tier (5,000 requests/day) or Pro trial
  3. Make First Call: Test the API with a simple transaction lookup
  4. Explore SupaApps: Try Wallet Profiler and KOL Watch
  5. Set Up Webhooks: Configure notifications for your use case

Learning Resources

  • API Documentation: Complete reference with examples
  • SupaApps Guide: Learn to use specialized analytical tools
  • Integration Examples: Code samples for popular programming languages
  • Video Tutorials: Step-by-step guides for common tasks

Community & Ecosystem

Official Channels

Partner Ecosystem

  • DEX Integration: Raydium, Jupiter, Meteora, Orca
  • Analytics Platforms: Birdeye, DexScreener, CoinGecko
  • Development Tools: Solana CLI, Anchor, Metaplex
  • Infrastructure: AWS, GCP, Azure, DigitalOcean

SupaScan - The most advanced Solana analytics platform, providing real-time access to indexed blockchain data with comprehensive APIs, specialized analytical tools, and intelligent monitoring capabilities.

Built with ❤️ by the SupaScan Team

Previous
Getting Started
Next
FAQ