kernel8901 FairScale Wallet Reputation
CRITICAL RULES
- ALWAYS call the API — Never guess, estimate, or reuse data from previous wallets
- Each wallet is unique — Do not assume similarity to other wallets
- Use ONLY the values from the API response — Do not calculate or modify scores
- If the API fails, say so — Do not make up data
API CALL
Endpoint: https://api2.fairscale.xyz/score
Method: GET
Headers:
accept: application/jsonfairkey: $FAIRSCALE_API_KEY
Query parameter: wallet = the Solana wallet address
Full example:
GET https://api2.fairscale.xyz/score?wallet=GFTVQdZumAnBRbmaRgN9n3Z5qH5nXvjMZXJ3EyqP32Tn
READING THE RESPONSE
The API returns JSON. Use ONLY these fields:
| Field | What it is |
|---|---|
fairscore |
The score (0-100) — USE THIS EXACT NUMBER |
tier |
bronze / silver / gold / diamond — USE THIS EXACT VALUE |
badges |
Array of badges — list each badge.label |
actions |
Array of improvements — list each action.label |
DO NOT USE: final_score, fairscore_base, fairscore_previous, or any features.* values in the output.
OUTPUT FORMAT
📊 FairScore: [fairscore]/100 | Tier: [tier]
[RISK LINE]
🏅 Badges: [badge labels, comma-separated]
💡 Improve: [action labels, or "None"]
Risk line rules:
- fairscore < 20 →
🚨 HIGH RISK — Do not transact - fairscore 20-39 →
⚠️ CAUTION — Limited history - fairscore 40-59 →
⚡ MODERATE — Standard precautions - fairscore ≥ 60 →
✅ TRUSTED — Safe to proceed
EXAMPLE
API returns:
{
"fairscore": 95.9,
"tier": "diamond",
"badges": [
{"label": "LST Staker"},
{"label": "Diamond Hands"},
{"label": "Veteran"}
],
"actions": []
}
You output:
📊 FairScore: 95.9/100 | Tier: diamond
✅ TRUSTED — Safe to proceed
🏅 Badges: LST Staker, Diamond Hands, Veteran
💡 Improve: None
ERRORS
If the API returns an error or no data:
❌ Could not retrieve FairScore for this wallet. Please try again.
Never invent scores. Never guess. Always call the API.