Token Health & Activity

Your token's health score measures how active your token is on-chain. It determines whether your registration stays in good standing or expires and becomes available for someone else to register.

How the Score Works

Your health score is a single number from 0-100, computed daily from three on-chain signals:

Signal	Weight	What It Measures
Activity timestamp	50%	How long since the listing was registered (a stepped decay)
Trading volume	30%	DEX volume, smoothed across 24h + 7d, capped against pool liquidity, then log-scaled (see below)
Holder Health Score	20%	Holder distribution shape — concentration, suspicious wallets, distribution breadth, scale (see below)

Verified social channels appear as a badge on your token page but do not affect the score. The score is a token-health signal; social verification is a separate identity signal.

Each daily commit is also annotated with a 0-100 confidence value derived from how recent the underlying market data was when the score was computed. Confidence is shown alongside the score in the API response so you can see at a glance how fresh the inputs were.

The operator's indexer recomputes scores once per day and publishes them as a single Merkle root commitment on-chain. Anyone can verify the score for any listing against that root — see the heartbeat oracle reference for the public RPC endpoints.

How the Volume Signal Works

Raw 24-hour volume is easy to inflate with wash trading. Two filters run before the score is computed:

• Smoothing: your effective volume is a blend of the last 24 hours and a trailing 7-day daily average (default 70/30). A single-day burst contributes only 70% of its value; the rest is anchored to the week. This damps wash-trading spikes without erasing real recent activity.
• Liquidity-anchored cap: your effective volume is capped at 100× the token's DEX pool liquidity. A token reporting $1M volume on $50 of pool liquidity is wash-trading by definition; the cap clamps that down without affecting honest tokens (real volume rarely exceeds 10-20× daily turnover). Newly-listed tokens with no pool data yet skip the cap entirely so they're not zeroed out before they have a market.

Both filters run on data from the same provider call as the holder distribution — no additional cost.

How the Holder Health Score Works

Raw holder counts are easy to game by splitting tokens across many wallets. The Holder Health Score evaluates the shape of token ownership instead, with four sub-components:

Sub-component	Share	What it captures
Concentration	40 of 100	How much of supply the top 10 / top 50 wallets control
Suspicious wallets	33 of 100	Snipers, bundlers, insiders, and sandwich attackers (labeled by the data provider)
Distribution	17 of 100	How many wallets together hold 50% of supply
Holder scale	10 of 100	Raw holder count, capped at 5,000 (EVM) or 50,000 (Solana)

Splitting balance across new wallets worsens concentration and distribution scores even as it inflates the raw count, so wallet-splitting attacks lower your score instead of raising it.

Status Thresholds

Score Range	Status	What It Means
60-100	Healthy	Registration in good standing
Below 60	At-Risk	The 30-day expiration countdown is running; alerts fire
Below 60 for 30 consecutive days	Expired	Ticker available for re-registration

Grace Period for New Registrations

Newly registered tokens receive a 30-day grace period during which the listing cannot be reclaimed regardless of score. This gives new tokens time to build organic activity.

During grace period:

• Your health score is tracked but does not trigger at-risk status
• The slot cannot be reclaimed, regardless of score
• Token page displays a "New" badge

The grace period is measured from the original first claim of the (symbol, chain, token contract) triple — releasing and re-registering does not reset it.

Reclaiming an Expired Slot

When a listing's score has been below 60 for 30 consecutive days and it is past its grace period, the registration expires and the slot becomes reclaimable. Expiry is enforced on-chain: anyone can submit a Merkle proof of the failing score to mark the listing inactive — no admin involvement.

Re-registering an expired ticker goes through the standard registration flow (see pricing), plus gas. There are no penalty fees and no per-wallet limits — activity decay plus first-claim-wins is the entire anti-squatting mechanism.

What Happens When a Registration Expires

Once a registration expires:

1. Status changes to "Expired" in search results
2. The slot reopens for re-registration — the original owner or anyone else who passes verification can register it through the standard flow, first-claim-wins
3. The original owner keeps no special claim on the slot; to get the ticker back they simply re-register (before someone else does)
4. Metadata and manager assignments are cleared when a new owner registers

Re-registration is first-come — no admin recovery

Expiry doesn't erase your ability to come back: until someone re-registers the open slot, you can re-register it yourself. But there are no admin functions to restore a registration — once another wallet re-registers an expired ticker, first-claim-wins makes it theirs, and support can't reverse it.

Tips for Maintaining a Healthy Score

• Keep trading active: Even small volume counts toward the 30% volume signal
• Grow your holder base genuinely: Concentration is the biggest piece of the holder health score; spreading supply across real wallets matters more than raw count
• Verify your socials: Verified social channels appear as a trust badge on your token page (they don't affect the health score, but they help users distinguish legitimate projects)
• Monitor your score: Watch your health score as a live metric in your token manager's Analytics tab
• Set up alerts: PRO subscribers receive health warning notifications before at-risk status triggers
• Use a multisig: Register from a Safe multisig wallet so team members can maintain activity even if one person is unavailable