strategy-dev

Embed your first Volume Health badge in 10 minutes

Public, auto-updating health score for your token

10 min · beginner

What you'll have when finished

  • Have one registered token with a live health score
  • Have the embed code copied + pasted on at least one surface
  • Understand what the 5 ratings mean

Before you start

  • Health score measures TRADING metrics looking organic — does NOT prove legitimate, audited, or compliant
  • PENDING rating on a new token is normal — data needs 24-72 hours to accumulate
  • Score updates every 5 min — embed shows the latest value, so old screenshots may not match

Walkthrough

  1. Open Volume Health + browse sample tokens

    Elite → Volume Health. Above your registered list, sample tokens (USDC, WETH, UNI, AAVE, LINK, PEPE) demonstrate scoring across categories. Click 2-3 to see how scoring varies by token type.

    Success criteria: You have seen at least 2 sample token health reports

  2. Click Register token

    Top-right button. Enter display name + contract address + network. 10 chains supported. Click Register.

    Success criteria: Your token appears in the registered list

  3. Wait for score to populate (30-60 sec to 24-72 hr)

    Initial computation takes 30-60 sec. If your token is brand new (under 24 hours of trading), you may see PENDING for 1-3 days while data accumulates. PENDING is normal, not a bug.

    Success criteria: Score is visible (or you understand PENDING is expected for new tokens)

  4. Read your 0-100 score + 5-tier rating

    EXCELLENT (green, 80+) / GOOD (blue, 65-79) / FAIR (amber, 50-64) / POOR (red, <50) / PENDING (gray). Below 50 is a red flag for investors. Focus more on TRAJECTORY than absolute number — improving 60→80 over 3 months tells a story.

    Success criteria: You can articulate your current rating and score

  5. Drill into the 6 factor breakdowns

    Volume consistency / Trading activity / Buy-sell balance / Liquidity depth / Holder distribution / Organic patterns. Each shows a progress bar + source badge (MARKET DATA / DEX METRICS / ON-CHAIN / HEURISTIC). Identify which factor is dragging your score — that is your highest-leverage fix.

    Success criteria: You know which 1-2 factors are pulling your score down

  6. Click Embed + copy the code

    5 format options: HTML iframe (websites), Markdown image (READMEs), BBCode (forums), direct URL (Twitter cards / Discord previews), JSON API (programmatic). Copy the format that matches your surface.

    Success criteria: You have one embed snippet in your clipboard

  7. Paste it where buyers will see

    Project website above-the-fold. Discord/Telegram pinned message. Twitter card. GitHub README. Any place buyers research your token. Badge auto-refreshes every 5 minutes — paste once, stays fresh.

    Success criteria: Embed visible on at least one public surface

What's next

You have one auto-updating public badge. Habit: track your score weekly. If a factor drops, investigate the root cause before viewers notice. Pair with Competitor Tracker to research how your competitors score — your relative position matters as much as absolute score.