token-scorer

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

SKILL.md

GitHub

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