risheea/fairscale-solana-skill

FairScale Reputation Skill

Check Solana wallet reputation scores. Free tier: 100 calls/day, no API key needed.

What This Does

FairScale provides reputation scores (0-100) for any Solana wallet based on 50+ on-chain signals. Use it to:

• Check a wallet's trustworthiness before transacting
• Filter wallets for airdrops or whitelists
• Build custom scoring models for your use case
• Add reputation data to your agent's decision-making

API Endpoint

https://x402.fairscale.xyz

No API key required for free tier.

---

Endpoints

GET /score

Get a wallet's reputation score.

GET https://x402.fairscale.xyz/score?wallet=WALLET_ADDRESS

Response:

{
  "wallet": "7xK9...",
  "fairscore": 72,
  "tier": "gold",
  "_meta": {
    "remaining_today": 99
  }
}

GET /check

Get a risk assessment for a specific transaction amount.

GET https://x402.fairscale.xyz/check?wallet=WALLET_ADDRESS&amount=500

Response:

{
  "wallet": "7xK9...",
  "fairscore": 72,
  "risk_level": "medium",
  "recommendation": "proceed_with_caution",
  "max_suggested_amount_usd": 1000
}

POST /score/custom

Create custom scoring rules. Requires credits.

POST https://x402.fairscale.xyz/score/custom
Content-Type: application/json

{
  "wallet": "WALLET_ADDRESS",
  "rules": {
    "min_score": 60,
    "min_age_days": 90,
    "no_rug_history": true
  }
}

Response:

{
  "wallet": "7xK9...",
  "passes": true,
  "rule_results": {
    "min_score": { "pass": true, "required": 60, "actual": 72 },
    "min_age_days": { "pass": true, "required": 90, "actual": 340 },
    "no_rug_history": { "pass": true }
  }
}

POST /batch

Score multiple wallets at once. Requires credits.

POST https://x402.fairscale.xyz/batch
Content-Type: application/json

{
  "wallets": ["wallet1", "wallet2", "wallet3"]
}

---

Custom Rules

Use these with /score/custom:

| Rule | Type | Example | |------|------|---------| | min_score | number | "min_score": 60 | | min_age_days | number | "min_age_days": 90 | | no_rug_history | boolean | "no_rug_history": true | | min_transaction_count | number | "min_transaction_count": 100 | | min_volume_usd | number | "min_volume_usd": 5000 | | max_burst_ratio | number | "max_burst_ratio": 0.5 | | min_tier | string | "min_tier": "silver" |

---

Score Guide

| Score | Tier | Meaning | |-------|------|---------| | 80-100 | Platinum | Highly trusted | | 60-79 | Gold | Good reputation | | 40-59 | Silver | Average | | 0-39 | Bronze | Low trust |

---

Pricing

| Tier | Limit | Cost | |------|-------|------| | Free | 100 calls/day | $0 | | Credits | Unlimited | $0.01/call |

Get Credits

1. Send USDC to: fairAUEuR1SCcHL254Vb3F3XpUWLruJ2a11f6QfANEN
2. Call POST /credits/deposit with your wallet and tx signature
3. Get a session token
4. Include x-session-token header on requests

---

Examples

Check a wallet:

GET https://x402.fairscale.xyz/score?wallet=7xK9abc...

Check risk for $500 trade:

GET https://x402.fairscale.xyz/check?wallet=7xK9abc...&amount=500

Custom rules for lending:

POST https://x402.fairscale.xyz/score/custom
{
  "wallet": "7xK9abc...",
  "rules": {
    "min_score": 70,
    "min_age_days": 180,
    "no_rug_history": true
  }
}

---

Monetise This Skill

Build products on top of FairScale:

• Gated access: Charge users to verify their reputation
• Airdrop filtering: Charge projects to filter sybils
• Lending checks: Charge per credit decision
• Premium verification: Offer "FairScale Verified" badges

Your agent can charge users while paying $0.01/call to FairScale.

---

Links

• Docs: https://docs.fairscale.xyz
• API: https://x402.fairscale.xyz