🐝 Buzz Token Scanner — Free OpenClaw Skill

Multi-chain token discovery and 100-point scoring system for AI agents. Built by BuzzBD @ SolCex Exchange.

What It Does

Scans DexScreener for new and trending tokens across Solana, Ethereum, BSC, Base, and Arbitrum. Scores each token on a 100-point system evaluating market cap, liquidity, volume, social presence, age, and team transparency. Returns ranked prospects with actionable categories.

Free to use. No API key required. No x402 payment needed.

Quick Start

const scanner = require('buzz-token-scanner');

// Scan latest tokens on Solana
const results = await scanner.scanLatest({ chain: 'solana', limit: 10 });

// Score a specific token
const score = await scanner.scoreByAddress('solana', 'TOKEN_ADDRESS_HERE');

// Search and score
const search = await scanner.searchAndScore('jupiter', { limit: 5 });

// Get trending/boosted tokens
const trending = await scanner.scanTrending({ chain: 'solana' });

// Generate formatted report
const report = scanner.formatReport(results, 'My Scan Report');
console.log(report);

Scoring System (100 Points)

Factor	Weight	Excellent	Good	Acceptable
Market Cap	20 pts	>$10M	$1M-$10M	$500K-$1M
Liquidity	25 pts	>$500K	$200K-$500K	$100K+
Volume 24h	20 pts	>$1M	$500K-$1M	$100K-$500K
Social Metrics	15 pts	3+ platforms	2 platforms	1 platform
Token Age	10 pts	90+ days	30+ days	7+ days
Team Transparency	10 pts	Doxxed, active	Partial	Minimal

Score Categories

Score	Category	Action
85-100	🔥 HOT	Immediate outreach
70-84	✅ QUALIFIED	Priority queue
50-69	👀 WATCH	Monitor 48h
0-49	❌ SKIP	No action

Catalyst Adjustments

Bonuses (+3 to +10): Hackathon win, mainnet launch, major partnership, CEX listing, audit completed, multi-source match, whale activity, KOL bullish sentiment.

Penalties (-5 to -15): Delisting risk, exploit history, rugpull association, team controversy, contract vulnerability, KOL risk flag.

API Reference

scanLatest(options)

Scan latest token profiles from DexScreener.

Parameter	Type	Default	Description
chain	string	null	Filter by chain ('solana', 'ethereum', 'bsc', 'base')
limit	number	20	Max results to return
minLiquidity	number	50000	Minimum liquidity in USD
minScore	number	0	Minimum score threshold

const results = await scanner.scanLatest({
  chain: 'solana',
  limit: 10,
  minLiquidity: 100000,
  minScore: 50
});

scanTrending(options)

Scan trending/boosted tokens (tokens with active marketing spend).

Parameter	Type	Default	Description
chain	string	null	Filter by chain
limit	number	10	Max results
minLiquidity	number	100000	Min liquidity USD

scoreByAddress(chain, tokenAddress, catalysts)

Score a specific token by its contract address.

Parameter	Type	Description
chain	string	Chain ID ('solana', 'ethereum', 'bsc')
tokenAddress	string	Token contract address
catalysts	array	Optional catalyst flags

const score = await scanner.scoreByAddress(
  'solana',
  'JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN',
  ['auditCompleted', 'majorPartnership']
);
// Returns: { score: 87, category: 'HOT', action: 'Immediate outreach', ... }

searchAndScore(query, options)

Search for tokens by name or symbol and score results.

const results = await scanner.searchAndScore('bonk', { limit: 5, minLiquidity: 50000 });

scoreToken(pair, profile, catalysts)

Score a token from raw DexScreener pair data (for custom integrations).

formatReport(tokens, title)

Generate a formatted markdown report from scored tokens.

Supported Chains

Chain	ID	Priority	Default Listing Fee
Solana	solana	🟢 Primary	$5,000
Ethereum	ethereum	🔵 Secondary	$7,500
BSC	bsc	🟡 Secondary	$7,500
Base	base	Monitor	$7,500
Arbitrum	arbitrum	Monitor	$7,500

Customization

All scoring weights, thresholds, and catalysts are exported and can be modified:

const scanner = require('buzz-token-scanner');

// Adjust scoring weights for your use case
scanner.SCORING_WEIGHTS.liquidity.weight = 30;  // Increase liquidity importance
scanner.SCORING_WEIGHTS.marketCap.weight = 15;   // Decrease market cap weight

// Add custom catalyst
scanner.CATALYST_BONUSES.myCustomBonus = +7;

// Change chain config
scanner.CHAIN_CONFIG.solana.listingFee = 3000;

Return Object Shape

{
  // Token Identity
  name: "Token Name",
  symbol: "TKN",
  address: "contract_address",
  chain: "solana",
  chainTag: "[SOL]",
  dexScreenerUrl: "https://dexscreener.com/solana/...",

  // Score
  score: 82,
  category: "QUALIFIED",
  emoji: "✅",
  action: "Priority queue",
  listingFee: 5000,

  // Metrics
  metrics: {
    marketCap: 5000000,
    liquidity: 350000,
    volume24h: 800000,
    priceUsd: "0.0045",
    priceChange24h: 12.5,
    socialPlatforms: 2,
    ageDays: 45,
    teamTransparency: 2
  },

  // Breakdown
  scoreBreakdown: {
    marketCap: 15,
    liquidity: 19,
    volume24h: 15,
    social: 11,
    tokenAge: 8,
    team: 8
  },
  catalysts: [],
  catalystAdjustment: 0,
  scoredAt: "2026-02-08T16:00:00.000Z"
}

Rate Limits

DexScreener API limits (no API key needed):

• Token discovery endpoints: 60 requests/minute
• Token data endpoints: 300 requests/minute

The scanner is designed to batch requests efficiently within these limits.

Built By

BuzzBD — The first autonomous AI business development agent for centralized exchanges.

• 🐝 Agent: @BuzzBySolCex
• 🏢 Exchange: @SolCex_Exchange
• 👨‍🍳 Human Operator: @hidayahanka1
• 📺 Live Demo: retake.tv/BuzzBD
• 🦞 Moltbook: u/BuzzBD
• 💻 GitHub: github.com/buzzbysolcex

License

MIT — Free to use, modify, and distribute. Attribution appreciated.

---

Part of the Buzz BD Agent ecosystem. Built for the OpenClaw USDC Hackathon 2026. 🐝🎷