---

name: token-scorer description: > Score any crypto token using Buzz's 11-rule scoring engine. Zero LLM cost — pure rule-based analysis across liquidity, volume, security, deployer identity, and market dynamics. Pulls from DexScreener API + on-chain data. Returns 0-100 score with COLD/WARM/HOT classification and actionable breakdown. tags: [crypto, defi, scoring, token, security, analysis]

Token Scorer — Buzz BD Agent

11 permanent rules. Zero LLM cost. Real-time scoring. API: https://api.buzzbd.ai/api/score/{address} Free widget: https://buzzbd.ai/score

When to Use

• Evaluating a token for listing potential
• Quick safety check before interaction
• Pipeline screening for BD outreach
• Hackathon demos requiring token intelligence

Scoring Rules (v2_8rules + 3 new)

#	Rule	Type	What It Catches
1	FDV Gap Penalty	Penalty	FDV/mcap divergence > 5x = inflated valuation
2	Stablecoin Exclusion	Filter	Stablecoins auto-excluded (not listing candidates)
3	Ghost Token Exclusion	Filter	No real on-chain activity = dead project
4	Contradictory Audit Hold	Hold	Conflicting security data = needs manual review
5	Security Penalty	Penalty	Flagged by Go+ Security / Token Sniffer / Honeypot.is
6	Liquidity Cross-Ref	Verify	Liquidity vs volume sanity check
7	Age Bonus	Bonus	Token age > 90 days = maturity signal
8	Volume Threshold	Filter	Minimum 24h volume required
9	GHOST_VOLUME	Penalty	Fake volume detection (wash trading patterns)
10	CTO_FLAG	Flag	Community takeover indicator (original team left)
11	VOLUME_LIQUIDITY_RATIO	Penalty	Suspicious volume/liquidity ratio > 10x

Score Bands

Range	Classification	Action
85-100	HOT	BD screening pipeline activated
70-84	WARM	Monitor, potential future candidate
50-69	COLD	Low priority, log and archive
0-49	REJECTED	Auto-filtered, do not pursue

Usage

Via API (x402 micropayment — $0.01 USDC on Base)

curl https://api.buzzbd.ai/api/score/0x...contractAddress

Via Claude Code

/score PEPE
/score 0x6982508145454Ce325dDbE47a25d4ec3d2311933

Via Free Widget

Visit https://buzzbd.ai/score — paste contract address, get instant score.

Via npm CLI

npx @buzzbd/scorer --token PEPE --chain ethereum

Response Format

{
  "token": "PEPE",
  "address": "0x6982...",
  "chain": "ethereum",
  "score": 78,
  "classification": "WARM",
  "breakdown": {
    "liquidity": { "score": 85, "value": "$12.4M" },
    "volume_24h": { "score": 72, "value": "$45.2M" },
    "security": { "score": 90, "penalties": [] },
    "deployer": { "score": 65, "identity": "ANON" },
    "age_days": 412,
    "fdv_gap": 1.2
  },
  "flags": [],
  "rules_triggered": ["AGE_BONUS"],
  "scored_at": "2026-04-05T08:00:00Z",
  "llm_cost": "$0.00"
}

Architecture Notes

• Scoring engine is 100% rule-based (zero LLM inference)
• Data pulled from DexScreener API (free tier)
• Identity verification via ATV (x402, $0.01/call)
• Results cached 1 hour in SQLite
• On-chain proof: ScoreStorage v2 on Base mainnet
• 482-token public leaderboard at buzzbd.ai/scores