Solana Token Scanner Documentation

TokenSight AI is an AI-powered token intelligence platform built for the Solana ecosystem. It helps traders and researchers make data-driven decisions by analyzing on-chain data, liquidity depth, holder distribution, trading volume, and social signals — all distilled into a single Intelligence Score.

Built and maintained by a solo full-stack developer passionate about crypto and cutting-edge web technology, TokenSight AI combines real-time blockchain data with intelligent scoring to give you an edge in the fast-moving world of Solana tokens.

Whether you are scouting newly launched tokens on Bags or evaluating established projects, TokenSight AI provides the signals you need — no noise, just intelligence.

The core of TokenSight AI. Paste any Solana token address and get an instant intelligence report with a full breakdown of on-chain and market data.

How the Intelligence Score works

The overall score (0–100) is the average of four sub-scores, each evaluating a different dimension of the token:

What you get in a scan result

• Token Logo & Name — The token's logo image, name, and symbol are displayed prominently at the top of the scan result.
• Animated score ring — Color-coded visual (red ≤30, yellow 31–59, blue 60–84, green 85+) with smooth fill animation and inline sub-scores.
• Security Badges — Three badges showing Mint authority (disabled = safe), Freeze authority (disabled = safe), and LP burn profile (strong = safe). Green means renounced/safe, red means still enabled/risky. Fetched from the Helius getAsset API.
• Trust Signals — Jupiter verification, strict tagging, suspicious audit status, organic score, and Helius metadata mutability. Optional rows like tax, max fee, and dev balance only appear when real provider data exists.
• Launch Metadata — Launch type, launchpad, first mint time, first pool time, first mint transaction, pool ids, and Bags launch context when available.
• Trading Flow — Jupiter Tokens V2 windows for 5m, 1h, 6h, and 24h showing buy volume, sell volume, traders, organic buyers, and price change.
• Liquidity Intelligence — Meteora DLMM + DAMM v2 liquidity analysis with total liquidity, protocol split, liquidity score, near-price coverage, reserve-based $100 / $1,000 price-impact estimates, and risk warnings.
• Intelligence Signals — AI-generated bullet points flagging key findings (e.g. "Strong holder base", "Low liquidity risk"). Each signal is auto-classified by severity with color-coded icons.
• Market Metrics — 7 cards showing Price, Liquidity, Volume (24h), Holders, Top 10 Wallet Concentration, Creator Tokens, and Market Cap. Large numbers use compact K/M/B formatting (e.g. $1.80M instead of $1,795,000).
• Holder Breakdown — Top 10 holder wallets with percentage bars and truncated wallet addresses. Each address has a copy button on hover. Shown for all tokens regardless of holder count.
• >1K Holder Warning — When a token has more than 1,000 holders, a caution banner appears explaining that Helius API cannot fully snapshot large holder sets, with a direct link to verify on Birdeye.
• Identity & Ownership — Key on-chain identity data: Token Mint address, Pool Address, Deployer wallet, Owner wallet, and Created timestamp. Each address has a copy-to-clipboard button.
• Links & Social — Aggregated social links: Website, Twitter, Telegram (clickable), Quote Token, Searched Mint address, and token Status (graduated, listed, etc.). Data sourced from Bags API, DexScreener, and Birdeye.
• AI Summary — A natural-language explanation with keyword highlighting (green for bullish like "strong", "healthy"; red for bearish like "extreme", "low"). Includes the >1K holder Birdeye link when applicable.
• Live Chart — Embedded token price chart powered by DexScreener.
• Swap Widget — Swap directly into the token via Jupiter with MEV protection, without leaving the page.
• Quick Actions — Add to portfolio and alert buttons stay visible for guests too. If a guest clicks them, a login prompt appears directly above the action bar instead of redirecting or hiding the buttons.

Risk Labels

How to use

1. Go to the Scan page.
2. Paste a Solana token address in the search bar.
3. Hit Scan and wait for the AI analysis (3-phase loading animation).
4. Review the overall score, 4 sub-scores (Quality, Momentum, Confidence, Risk Cap), and security badges (Mint, Freeze, LP Burn).
5. Check Trust Signals, Launch Metadata, Trading Flow, and Liquidity Intelligence to understand verification, launch structure, execution depth, and slippage risk.
6. Review signals, market metrics (including Market Cap), holder breakdown with wallet addresses, and identity & ownership data.
7. Review links & social, the AI summary, and live chart.
8. Use the swap widget or quick actions directly from the result. Guests can click the quick actions and then authenticate from the bottom prompt.

Scan Layout

Results are displayed as a multi-section dashboard with glowing widget borders:

• Protocol layer — Trust Signals, Bags-specific fee or behavior details when available, and Launch Metadata
• Flow & Liquidity — Jupiter Trading Flow followed by the Meteora Liquidity Intelligence widget
• Core analysis — Intelligence Signals, Live Chart, Market Metrics, Holder Breakdown, and Identity & Ownership
• Execution layer — AI Summary, Swap Widget, Links & Social, and bottom quick actions

On mobile, all widgets stack vertically. Optional trust or fee rows stay hidden if provider data does not exist, and the guest login prompt opens above the quick-action buttons.

Guest users get a limited number of daily scans. Log in for unlimited access.

Track your Solana token holdings, monitor live prices, and see your ROI at a glance.

Features

• Live price tracking — Current prices fetched automatically via DexScreener.
• ROI calculation — See profit/loss percentage for each holding in real time.
• Risk tagging — Assign LOW, MEDIUM, or HIGH risk to each position.
• Notes — Add personal notes or thesis for each token.
• Summary cards — Total holdings, invested value, live portfolio value, and overall PnL.

How to use

1. Navigate to the Portfolio page.
2. Fill in the token address, name, quantity, and entry price.
3. Click Add to Portfolio.
4. Your holdings will appear with live prices and ROI updates.
5. Edit or delete entries anytime.

Set up price alerts for any Solana token and get notified when your conditions are met.

Alert Types

• Price Drop — Triggers when the token price falls below your threshold.
• Price Rise — Triggers when the token price rises above your threshold.
• Volume Spike — Triggers on unusual volume activity.

How to use

1. Go to Alerts and enter a token address.
2. Select the alert type and set your price threshold.
3. Click Create Alert.
4. Active alerts are listed below, showing status (ACTIVE/TRIGGERED) and last checked time.
5. Alerts can be sent to your linked Telegram for instant notifications.

Compete with other users and climb the ranks based on your scanning activity and accuracy.

How it works

• XP & Levels — Earn XP for every scan. More scans = higher level.
• Leagues — Progress through leagues (Bronze, Silver, Gold, etc.) as you level up.
• Streaks — Maintain daily scan streaks for bonus recognition.
• Rankings — See where you stand against the community on the public leaderboard.

Connect your Telegram account to receive scan results and price alerts directly in your chat via @TokenSightai_bot.

Current features

• Alert notifications — Get instant Telegram messages when your price alerts trigger.
• Scan results — Receive token scan summaries right in Telegram.

How to link

1. Open @TokenSightai_bot in Telegram and tap /start.
2. The bot will reply with your Telegram ID.
3. Go to Settings → Telegram on TokenSight AI.
4. Paste your Telegram ID and click Link.
5. You will now receive notifications for triggered alerts.

More Telegram bot features are actively being developed — including inline scanning and portfolio summaries.

Your personal dashboard — track your progress, manage your identity, and see how you stack up against the community.

Profile Card

• Avatar & Display Name — Customize your profile identity. Wallet-login users see a truncated address by default.
• Edit Profile — Update your username and avatar anytime via the edit button.
• Join Date — Shows when you created your account.
• Global Rank — Your position on the public leaderboard (e.g. #12).
• Skill Class — Automatically assigned based on your detection accuracy: Elite Analyst (≥70%), Skilled (≥50%), or Learning (<50%).

Streak & League

• Active Streak — Your current consecutive-day scan streak, displayed with a fire animation. Scan daily to keep it alive!
• League Tier — Determined by your total lifetime scans. Progress through Bronze, Silver, Gold, and beyond. Each league has its own color and badge.

Stats Dashboard

Additional Features

• Wallet Settings — Connect or manage your Solana wallet. Wallet-login users have special handling.
• Scan History Link — Quick access to your full paginated scan history.
• Disconnect Session — Sign out securely from your current session.

Every scan you run is saved to your personal history. Review past analyses, compare scores over time, and track how your token picks have evolved.

• View token name, score, risk level, and scan date for every past scan.
• Paginated and sortable for easy browsing.
• Available only for logged-in users.

Sight AI is the built-in AI assistant that lives inside TokenSight AI. It appears as a floating chat bubble on every page, giving you instant, conversational access to the platform’s intelligence engine without leaving your current workflow.

What Sight AI can do

• Token lookup — Ask about any Solana token by name or contract address. Sight AI fetches real-time price, liquidity, volume, market cap, holder count, and exchange listings.
• Full scan summaries — Request a complete scan and get the Intelligence Score, risk label, security badges, and AI-generated signals summarized in chat.
• Specific metrics — Ask for just the price, liquidity, holders, or any single metric and get a focused answer.
• Market & exchange links — Ask where to buy or trade a token and get direct links to DexScreener, Birdeye, Jupiter, and more.
• Alert management — Create price-drop, price-rise, or score-change alerts directly from chat.
• Profile updates — Change your display name or avatar by telling Sight AI.
• Platform guidance — Ask how features work, what the leaderboard tracks, how streaks are calculated, or anything from the docs.

How it works

1. Click the Sight AI bubble in the bottom-right corner of any page.
2. Type a question or paste a token address.
3. Sight AI determines intent — token data, platform help, or an action — and responds with live data, cards, and links.
4. For token queries, it pulls data from Birdeye, DexScreener, GeckoTerminal, and the scan engine in real time.
5. For open-ended questions, it uses OpenRouter (GPT-4o‑mini) grounded in TokenSight context so answers stay accurate.

Design principles

• Grounded in live data — Every token answer comes from the same data pipeline as the scanner, not from the AI model’s training data.
• No hallucination — If data is unavailable, Sight AI says so instead of making up numbers.
• Action-capable — Alerts and profile changes execute server-side; Sight AI confirms only after the action actually succeeds.
• Stateless per session — Chat resets on page reload for privacy. No conversation history is stored.

Sight AI is available to all users. Some actions (alerts, profile edits) require being logged in.

TokenSight AI is powered by a modern stack and the best data providers in the Solana ecosystem:

TokenSight AI is actively evolving. Here is what is in the pipeline: