DOCUMENTATION

USER GUIDE

Complete guide to using Tokenomics Lab for multi-chain token risk analysis. Learn how to scan tokens, interpret risk scores, and protect your investments.

01. GETTING STARTED

Create Your Account

1. Click "SIGN UP" in the top navigation

2. Enter your email and create a secure password

3. Verify your email address (check spam folder)

4. You'll start with a FREE account (10 scans/day)

Your First Token Scan

1. Navigate to your dashboard after logging in

2. Enter a token contract address or search by name

3. Select the correct blockchain network

4. Click "ANALYZE TOKEN" to start the scan

5. Results appear in 3-5 seconds with full risk breakdown

02. SCANNING TOKENS

Search Methods

⊡ By Contract Address

Paste the full token contract address:

0x95aD61b0a150d79219dCF64E1E6Cc01f0B64C4cE

⊡ By Token Name/Symbol

Use CoinMarketCap integration to search:

  • Type token name (e.g., "Pepe")
  • Select from dropdown suggestions
  • Auto-fills contract address

⊡ Chain Selection

Always select the correct blockchain:

  • ◆ Ethereum (ETH)
  • ◇ Binance Smart Chain (BSC)
  • ▲ Polygon (MATIC)
  • △ Avalanche (AVAX)
  • ● Solana (SOL)

03. UNDERSTANDING RISK SCORES

Risk Levels
LOW RISK (0-34)

Safe to invest. Token shows strong fundamentals, verified contracts, good liquidity, and decentralized ownership.

MEDIUM RISK (35-49)

Proceed with caution. Some concerning factors detected. Research thoroughly before investing.

HIGH RISK (50-74)

High risk detected. Multiple red flags present. Only invest what you can afford to lose.

CRITICAL RISK (75-100)

Avoid investment. Likely scam, honeypot, or rug pull. Critical security issues detected.

10 Risk Factors Analyzed

1. Supply Dilution

FDV/Market Cap ratio, mintable tokens, unlimited supply risks

2. Holder Concentration

Top 10/50/100 holder percentages, unique buyers, wash trading

3. Liquidity Depth

Liquidity amount, MC/Liq ratio, LP lock status, liquidity drops

4. Vesting & Unlocks

Upcoming token unlocks, team vesting schedules

5. Contract Control

Honeypot detection, mintable flags, ownership, freeze authority

6. Tax & Fees

Buy/sell taxes, modifiable tax rates

7. Distribution

Team allocation, holder distribution fairness

8. Burn & Deflation

Burn rate, deflationary mechanisms, supply cap

9. Adoption & Usage

Transaction count, volume/MC ratio, age-adjusted metrics

10. Audit & Transparency

Contract verification, open source status, audit reports

04. AI MEME DETECTION

How It Works

Our AI (powered by Groq Llama 3.3 70B) analyzes token metadata to automatically classify tokens as either MEME or UTILITY.

Classification Process:

  1. Token name and symbol analyzed
  2. AI detects meme-related patterns
  3. Confidence score calculated (0-100%)
  4. Classification applied: ◐ MEME or ◧ UTILITY

⚠️ Meme Token Penalty

Tokens classified as MEME automatically receive +15 risk points due to:

  • High volatility and price swings
  • Speculative nature
  • Community-driven value
  • Lack of utility or real-world use case

Manual Override

Don't agree with the AI? You can manually override the classification:

  • ⊕ Auto Detect (default AI classification)
  • ◐ Force Meme Token classification
  • ◧ Force Utility Token classification

05. SUPPORTED BLOCKCHAINS

Ethereum (ETH)

Chain ID: 1

Data Sources: Mobula, Moralis, GoPlus

Features: Full contract analysis, holder tracking, liquidity monitoring

Binance Smart Chain

Chain ID: 56

Data Sources: Mobula, Moralis, GoPlus

Features: Fast scans, PancakeSwap integration

Polygon (MATIC)

Chain ID: 137

Data Sources: Mobula, Moralis, GoPlus

Features: Low-cost analysis, QuickSwap support

Solana (SOL)

Chain ID: 501

Data Sources: Mobula, Helius, GoPlus

Special: Freeze authority detection, mint authority checks

Avalanche (AVAX)

Chain ID: 43114

Data Sources: Mobula, Moralis

Features: Trader Joe integration

Arbitrum

Chain ID: 42161

Data Sources: Mobula, Moralis

Features: Layer 2 optimized scanning

06. PRICING PLANS

FREE (PUBLIC UTILITY)
$0.00/month
Honeypot Check
Risk Score (0-100)
Standard Charts
PDF Export (watermarked)
AI Risk Analyst
Portfolio Audit
Smart Alerts
⚠️ Ad-supported interface
PAY-AS-YOU-GO (x402)
Micropayments
USDC on Base
All Free features
AI Risk Analyst ($0.10/report)
Portfolio Audit ($0.05/token)
Enhanced Charts
Unbranded PDF Export
Ad-Free (24h after payment)
Smart Alerts
PRO PLAN (SUBSCRIPTION)
$29.00/month
Active daily traders
Unlimited Access
Smart Alerts (24/7 monitoring)
Custom Branding
Enhanced Charts
Always Ad-Free
Priority Support
✓ Best value for power users
What is x402 Protocol?

The x402 protocol enables micropayments for individual features without monthly subscriptions. Perfect for casual traders who only need occasional AI analysis or portfolio audits.

How it works:

  1. Connect your wallet (supports Base network)
  2. Pay with USDC for individual features
  3. No monthly commitments or subscriptions
  4. Payments as low as $0.05 per token audit
Choose Your Plan

Start with Free to test the platform, upgrade to Pay-As-You-Go for occasional use, or go Pro for unlimited access.

07. WATCHLIST MANAGEMENT

Adding Tokens to Watchlist

After scanning a token, click "Add to Watchlist" to track it:

  • FREE users: Up to 5 tokens
  • PREMIUM users: Unlimited tokens
  • Tokens update automatically with latest risk scores
  • View all watchlist tokens from your dashboard
Alerts (Premium Only)

Premium users receive automatic alerts when:

  • Risk score increases significantly
  • New critical flags detected
  • Liquidity drops below threshold
  • Holder concentration changes

Configure alert preferences in your profile settings.

08. FREQUENTLY ASKED QUESTIONS

How accurate are the risk scores?

Our 10-factor algorithm analyzes real-time data from multiple sources (Mobula, Moralis, GoPlus, Helius). Confidence scores range from 70-96% depending on data availability. Pro users get the highest confidence scores due to additional data sources and 24/7 monitoring.

How does the x402 micropayment system work?

x402 enables micropayments using USDC on Base network. Connect your wallet, pay only for features you use (AI reports, portfolio audits) without monthly subscriptions. Perfect for casual traders.

What makes a token "high risk"?

High risk tokens typically have: honeypot detection, mintable contracts, unlocked liquidity, concentrated ownership (top 10 holders > 70%), low liquidity (< $50K), or are classified as meme tokens with no utility.

Can I scan tokens on any blockchain?

We support 6 major blockchains: Ethereum, BSC, Polygon, Avalanche, Arbitrum, and Solana. More chains coming soon. Always select the correct chain when scanning to ensure accurate results.

What is the meme token penalty?

Tokens classified as meme coins automatically receive +15 risk points due to their speculative nature and high volatility. This helps users understand the additional risk of investing in community-driven tokens without real utility.

How often is data updated?

Every scan fetches fresh data from APIs in real-time. Watchlist tokens update every 15 minutes for Pro users, every hour for Pay-As-You-Go users, and daily for Free users. Historical charts update daily across all tiers.

Is my data private and secure?

Yes. We use Firebase Authentication with industry-standard encryption. Your watchlist and scan history are private and only accessible to you. We are GDPR compliant and never sell user data. See our Privacy Policy for details.

Can I cancel my Pro Plan subscription?

Yes, you can cancel anytime from your profile settings. You'll retain Pro access until the end of your billing period, then automatically revert to the Free tier.

What if a token shows "No data available"?

This means the token is not listed on major data aggregators yet, or the contract address is incorrect. Verify the address and chain selection. Very new tokens (< 24 hours) may not have sufficient data for analysis.

NEED MORE HELP?

PROFILE SETTINGS

Manage your account, upgrade to Premium, and configure preferences

PRICING

Compare Free vs Premium features and upgrade your account

CONTACT US

Have questions? Reach out to our support team

READY TO START ANALYZING?

Join thousands of users protecting their crypto investments with AI-powered risk analysis.