FAQ

General Questions

What is SupaScan?

SupaScan is an advanced blockchain analytics platform for Solana that provides real-time indexing, comprehensive data analysis, and powerful APIs for developers, traders, and analysts.

What makes SupaScan unique?

  • Real-time indexing with sub-second latency
  • Comprehensive data coverage - all Solana transactions, tokens, wallets, and DEX activity
  • Advanced analytics through SupaApps (Wallet Profiler, KOL Watch, PnL Detective)
  • Multiple access methods - REST API, SQL API, WebSocket, Webhooks, GraphQL
  • Enterprise-grade infrastructure with ClickHouse cluster

Is SupaScan free to use?

SupaScan offers multiple pricing tiers:

  • Free Tier: 1,000 API requests/day, basic analytics
  • Pro Tier: 100,000 requests/day, advanced features, webhooks
  • Enterprise: Unlimited requests, custom endpoints, dedicated support

How real-time is the data?

SupaScan provides sub-second latency for new blockchain data:

  • Block indexing: < 500ms behind Solana L1
  • API responses: < 100ms average
  • WebSocket updates: < 50ms for real-time events

API & Access Questions

How do I get started with SupaScan API?

  1. Sign up at supascan.com
  2. Generate API key in your dashboard
  3. Start with REST API - simple HTTP requests
  4. Explore SupaApps for advanced analytics
  5. Set up webhooks for real-time notifications

What data can I access through the API?

  • Transactions: All Solana transactions with full details
  • Token Data: Metadata, transfers, swaps, liquidity
  • Wallet Analysis: Profiles, trading patterns, PnL
  • DEX Activity: Swaps across Raydium, Meteora, PumpFun
  • Social Signals: Twitter mentions, influencer activity
  • Market Data: Volume, price changes, holder counts

Can I access historical data?

Yes! SupaScan maintains complete historical data:

  • Full Solana history from genesis
  • Token creation events with metadata
  • All DEX trades and liquidity changes
  • Wallet transaction history with patterns
  • Social media correlations

What's the difference between REST API and SQL API?

  • REST API: Pre-built endpoints for common queries, easy to use
  • SQL API: Direct ClickHouse access, unlimited query flexibility
  • GraphQL: Flexible data fetching with single requests
  • WebSocket: Real-time streaming for live updates

Rate Limits & Pricing

What are the API rate limits?

Free Tier:

  • 1,000 requests/day
  • 10 requests/minute
  • Basic endpoints only

Pro Tier:

  • 100,000 requests/day
  • 1,000 requests/minute
  • All endpoints + webhooks

Enterprise:

  • Unlimited requests
  • Custom rate limits
  • Dedicated infrastructure

How are requests counted?

  • REST API calls: 1 request per HTTP call
  • SQL queries: 1 request per query execution
  • WebSocket connections: No rate limit (separate pricing)
  • Webhook deliveries: Included in tier limits

What happens when I hit rate limits?

  • Soft limit: Requests throttled to 1/second
  • Hard limit: HTTP 429 error with retry-after header
  • Upgrade prompt: Clear messaging about tier limits
  • Usage dashboard: Real-time usage monitoring

Can I get higher limits?

Yes! Contact support for:

  • Custom rate limits for your use case
  • Enterprise pricing with dedicated resources
  • Volume discounts for high-usage applications

SupaApps & Analytics

What are SupaApps?

SupaApps are specialized analytical tools built on SupaScan data:

  • Wallet Profiler: Complete wallet analysis with trading patterns
  • KOL Watch: Track influencer activity and token mentions
  • PnL Detective: Calculate profit/loss for any wallet
  • Rebirth Monitor: Find tokens that suddenly gained activity
  • Farmer Classifier: Identify airdrop farming patterns
  • Ape Detector: Spot early token buyers

How accurate is the wallet analysis?

SupaScan provides 99.9% accuracy through:

  • Real-time indexing from Solana L1
  • Advanced parsing of all transaction types
  • Machine learning for pattern recognition
  • Continuous validation against blockchain state

Can I track specific tokens or wallets?

Yes! You can:

  • Monitor any wallet for activity changes
  • Track token metrics in real-time
  • Set up alerts for specific events
  • Analyze trading patterns with historical data
  • Compare performance across multiple wallets

What DEX protocols are supported?

SupaScan supports all major Solana DEXs:

  • Raydium: AMM and CLMM pools
  • Meteora: Dynamic pools and DLMM
  • PumpFun: Meme token launches
  • Jupiter: Aggregator swaps
  • Orca: Whirlpools and concentrated liquidity

Webhooks & Real-time

How do webhooks work?

Webhooks provide real-time notifications for blockchain events:

  • Token Creation: New tokens matching your criteria
  • Large Transfers: Transfers above specified thresholds
  • DEX Activity: Swaps on specific protocols
  • Wallet Activity: New transactions from monitored wallets
  • Social Signals: Twitter mentions or influencer activity

What webhook filters are available?

  • Token filters: Name contains, supply range, deployer wallet
  • Volume filters: Minimum liquidity, trading volume
  • Social filters: Influencer mentions, sentiment analysis
  • Custom filters: Any combination of criteria
  • Rate limiting: Cooldown periods, max notifications

How reliable are webhook deliveries?

SupaScan guarantees 99.9% delivery rate with:

  • Automatic retries with exponential backoff
  • Delivery confirmations with status tracking
  • Dead letter queues for failed deliveries
  • Webhook health monitoring and alerts

Can I test my webhook endpoint?

Yes! Use the webhook testing feature:

  • Test payloads with sample data
  • Delivery verification with status codes
  • Error debugging with detailed logs
  • Rate limit testing to verify your endpoint capacity

Privacy & Security

Is my API data secure?

Yes! SupaScan implements enterprise-grade security:

  • API Key Encryption: All keys encrypted at rest and in transit
  • HTTPS Only: All API communications use TLS 1.3
  • Data Isolation: Each user's data is completely isolated
  • Audit Logging: All API access is logged and monitored
  • SOC 2 Compliance: Enterprise security standards

Can I use SupaScan for sensitive applications?

Absolutely! SupaScan is trusted by:

  • Hedge funds for trading analytics
  • DeFi protocols for risk management
  • Institutions for compliance monitoring
  • Security firms for blockchain forensics

What data does SupaScan store?

SupaScan only stores:

  • Public blockchain data (already on-chain)
  • API usage metrics for billing and optimization
  • User preferences for customizations
  • No personal information beyond email for account management

Support & Community

How do I get help?

24/7 Support Channels:

What support do I get with each tier?

Free Tier:

  • Community support (Discord/Telegram)
  • Documentation and guides
  • Basic troubleshooting

Pro Tier:

  • Email support (24/7)
  • Priority response time
  • Advanced troubleshooting
  • Feature requests

Enterprise:

  • Dedicated account manager
  • Phone support
  • Custom integrations
  • SLA guarantees

How do I report bugs?

  1. Check existing issues on GitHub
  2. Provide detailed information:
    • API endpoint used
    • Request/response examples
    • Error messages and timestamps
    • Your API key tier (for rate limit issues)
  3. Include reproduction steps if possible

Can I request new features?

Yes! We love feature requests:

  • GitHub Discussions for technical features
  • Discord suggestions for community voting
  • Enterprise customers get direct feature requests
  • Open source contributions welcome

Is there a developer community?

Absolutely! Join our growing community:

  • Discord: 5,000+ developers and analysts
  • GitHub: Open source tools and examples
  • Documentation: Comprehensive guides and tutorials
  • Blog: Technical articles and case studies
  • Events: Regular webinars and workshops

Still have questions?

Previous
SupaScan Overview
Next
API Reference