getting-started

Your first Token Scanner (Solana volume breakouts)

Run a real cross-chain scan and learn to read the universe stats

15 min · beginner

What you'll have when finished

  • Have one saved scan running on Solana every hour
  • Know how to read universe stats + partial-run reasons
  • Be ready to clone, customize, and stack multiple scans

Before you start

  • "No matches" is a real and honest result — do not lower thresholds to force matches
  • Status=partial means a chain or data source was unavailable. Read partialReasons before acting
  • Templates are starting points, not prescriptions — cross-check matches against a chart AND the safety score before trading

Walkthrough

  1. Open Token Scanner + read the policy banner

    Discover → Token Scanner. The green banner at top says "Public methodology — verifiable without an account" and links to /api/scanner/policy. Click the link once to see what we publish (criterion formulas, scoring methods, known limits). This is the disclosure layer DEXScreener / DEXTools refuse to ship.

    Success criteria: You have seen /api/scanner/policy at least once

  2. Clone the "Solana volume breakouts" template

    Scroll to Templates section at the bottom. Click "Volume breakouts (Solana memecoins)". The Builder opens pre-filled with: Solana chain, 25k min liquidity, 24h min age, three criteria (VOLUME_SPIKE 5×, PRICE_CHANGE_PERCENT +3% to +30% on 1h, LIQUIDITY_FLOOR 25k).

    Success criteria: Builder view is open with Solana volume breakouts pre-filled

  3. Rename it + tighten the universe

    Change name to "My Solana volume scan v1". Increase Min liquidity to 50k (cuts rug noise). Add Max age = 30 days (focus on recent tokens, not established Solana memes that already moved).

    Success criteria: Name updated; min liquidity = 50000; max age = 720 hours

  4. Pick weighted_average scoring + hourly schedule

    Scoring method = weighted_average (default — combines all 3 criterion scores into one ranked number). Schedule frequency = hourly. Enabled = on. Leave alerts off for now.

    Success criteria: Scoring = weighted_average AND schedule = hourly AND enabled = true

  5. Save + Run now

    Click Save. Scan appears in your List with status "never run". Click Run now. The worker fetches the Solana universe, applies your filters + criteria, scores matches, returns results within 30-60 seconds.

    Success criteria: Results view opens showing status badge (hopefully complete, possibly partial)

  6. Read the universe stats card

    Top of Results: totalTokensConsidered = how many Solana tokens existed in our universe at scan time. tokensIncludedInScan = how many passed the universe filters (liquidity / age / exclusions). Exclusion breakdown shows WHY tokens were excluded. exclusionInvariantOk should be true (means included + excluded = considered, no math errors).

    Success criteria: You can articulate how many tokens were considered, included, and excluded for what reasons

  7. Read the matches (or the "no matches" answer)

    If matches exist: top 10 listed with score breakdown per criterion. Click any match for chart + safety score + DEX swap link. If no matches: "0 of N in-scope tokens passed all criteria — adjust thresholds." This is an honest answer, not a failure. Either widen thresholds slightly (4× volume spike instead of 5×) OR wait for hourly auto-runs to catch real breakouts.

    Success criteria: You can name the top 1-3 matches (if any) AND their scores, OR you can articulate why zero matches is acceptable

  8. Save the methodology hash

    Bottom of Results card: SHA-256 methodology hash. Copy it. Paste into a personal notes app with date + scan name. If you ever trade based on a match, you can re-run the same hash anytime and audit-prove the same methodology was applied.

    Success criteria: You have one methodology hash recorded in notes

What's next

You have a real Solana scan running hourly. Next experiments: clone the "Ethereum established movers" template for a different universe; clone "Multi-chain new launches" to catch fresh Base/Arbitrum/Polygon launches; raise min liquidity to 250k on the established-mover scan to surface only real-money moves. Build a portfolio of 3-5 scans across chains and review the matches once a week.