curl "https://api.fairscale.xyz/score?wallet=WALLET_ADDRESS" \
-H "fairkey: zpka_your_key_here"
Optional: &twitter=handle to bind X and enrich social score.
Response
{
"wallet": "5G5HDvbib4CyHxVgm4RHiVY5RfbDuFfp6BiH5xgZXczT",
"fairscore": 71.41,
"fairscore_base": 40.4,
"social_score": 55.3,
"peer_score": 1.9,
"verified_human": true,
"identity_pillar": 5,
"program_pillar": 30,
"score_composition": {
"core_blend": 36.41,
"final_score": 71.41
},
"tier": "gold",
"features": { "tx_count": 31.25, "no_instant_dumps": 100 },
"timestamp": "2026-07-04T13:01:46.437464Z"
}
| Field | Notes |
|---|---|
fairscore | 0–100 final score |
fairscore_base | On-chain model only |
verified_human | VeryAI palm attestation |
score_composition | Pillar breakdown |
features | 15 on-chain signals |
ownership | 01Resolved ICO + governance : details |
Shortcuts
| Endpoint | Returns |
|---|---|
GET /fairScore | { "fair_score": 714 } (0–1000) |
GET /walletScore | On-chain only, 0–1000 |
GET /socialScore | { "social_score": 553 } (0-1000) |
Cache: 15 min. Bypass: ?nocache=1.