Wallet Score Endpoint
GET /walletScore
Returns only the on-chain component of the FairScore as an integer (0–1000). Social reputation and peer reviews are excluded.
Use this when you're scoring wallets without linked social identities — e.g. pure DeFi risk scoring, Sybil filtering on freshly-seen wallets, or contexts where social signal is noise.
Endpoint
GET https://api.fairscale.xyz/walletScore?wallet=WALLET_ADDRESS
| Parameter | Type | Required | Description |
|---|---|---|---|
wallet | string | Yes | Solana wallet address |
| Header | Required | Description |
|---|---|---|
fairkey | Yes | API key |
Response
{ "wallet_score": 581 }
| Field | Type | Description |
|---|---|---|
wallet_score | integer | On-chain score on a 0–1000 scale (fairscore_base × 10) |
How It's Calculated
wallet_score is the raw output of the on-chain neural network — the same model that produces fairscore_base in the full /score response. It considers:
- Portfolio composition (SOL, majors, stables, LSTs)
- Capital flow over the last 30 days
- Holding conviction (median hold, no-instant-dumps)
- Activity tempo (count, active days, gaps)
- Trading behaviour (timing variance, burst ratio)
- Platform diversity and wallet age
It does not include:
- Linked X/Twitter activity
- Peer reviews / vouches
- VeryAI humanity attestation
For the blended score including those signals, use /fairScore or the full /score endpoint.
Example
curl -X GET "https://api.fairscale.xyz/walletScore?wallet=WALLET_ADDRESS" \
-H "fairkey: YOUR_API_KEY"
// SDK equivalent
const { wallet_score } = await client.human.walletScoreOnly("WALLET_ADDRESS");
See Also
/score— full response with all 15 features and badges/fairScore— blended social + on-chain score