fairscale-solana_skill

Overview

This skill provides instant Solana wallet reputation intelligence using FairScale. Ask plain-English questions like "is this a bot?", "whale?", or "diamond hands?" and get concise verdicts with the underlying FairScore and relevant badges. It supports both API-key and micropayment access methods and always fetches live data — never guesses.

How this skill works

The skill calls FairScale's /score endpoint for the target wallet and extracts fairscore, tier, badges, and feature metrics. If an API key is configured ($FAIRSCALE_API_KEY) it uses that; otherwise it attempts the x402 micropayment flow. It maps natural-language queries to specific features (e.g., burst_ratio for bots, conviction_ratio for "diamond hands") and returns a short verdict plus supporting metrics.

When to use it

• Quickly assess trust or risk before interacting with a Solana wallet
• Check if a wallet is likely a bot, whale, OG, or airdrop-eligible
• Automate pre-trade or on-chain screening in bots or dashboards
• Validate eligibility for promotions, airdrops, or credit decisions
• Run custom rules against live wallet metrics

Best practices

• Always call the API for fresh data; do not reuse or invent scores
• Check $FAIRSCALE_API_KEY first and prefer Method 1 when available
• If no API key, enable an agent wallet for x402 micropayments
• Return a short verdict plus the fairscore and 2–3 supporting metrics
• Expose custom criteria support so users can override thresholds

Example use cases

• User: "Is this wallet a bot?" → Skill returns burst_ratio, platform_diversity, and a Bot/Human verdict
• User: "Whale check for ADDRESS" → Skill evaluates LST, stablecoin, and native SOL percentiles and gives Whale/Partial/Not a whale
• User: "Airdrop eligible?" → Skill checks wallet_age_score, platform_diversity, and burst_ratio and returns Eligible/Not eligible
• Developer: "Run custom rule conviction > 70" → Skill evaluates conviction_ratio and returns pass/fail with value
• Automation: Pre-trade filter that blocks wallets with fairscore < 40 (Caution/High Risk)