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. PREMIUM FEATURES

FREE TIER
10 scans per day
Basic risk analysis
5 watchlist tokens
2 dashboard charts
Multi-chain support
PREMIUM TIER
Unlimited scans
AI-powered insights
Unlimited watchlist
4 advanced charts
Real-time alerts
Historical analytics
Priority support
Upgrade to Premium

Ready to unlock all features? Upgrade from your profile page or dashboard.

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. Premium users get higher confidence scores due to additional data sources.

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 are updated every 15 minutes for Premium users, every hour for Free users. Historical charts update daily.

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 Premium subscription?

Yes, you can cancel anytime from your profile settings. You'll retain Premium 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.