GET /socialScore
Returns only the social component of the FairScore as an integer (0-1000 scale). On-chain features, badges, and tier are excluded.
Use this when you already have on-chain signals elsewhere and only need social reputation, or when gating on linked X activity and peer vouches.
Endpoint
GET https://api.fairscale.xyz/socialScore?wallet=WALLET_ADDRESS
| Parameter | Type | Required | Description |
|---|---|---|---|
wallet | string | Yes | Solana wallet address |
twitter | string | No | X/Twitter handle for social enrichment |
| Header | Required | Description |
|---|---|---|
fairkey | Yes | API key |
Response
{ "social_score": 553 }
| Field | Type | Description |
|---|---|---|
social_score | integer | Social score on a 0-1000 scale (social_score × 10 from /score) |
How It Relates to /score
In the full /score response, social_score is on a 0-100 decimal scale. /socialScore returns the same value multiplied by 10 as an integer, matching /fairScore and /walletScore shortcut conventions.
Social signal includes:
- Linked X/Twitter activity (when bound via
twitterparam or prior linkage) - Peer reviews and vouches
- VeryAI humanity attestation (contributes to identity, reflected in blended score)
It does not include:
- On-chain portfolio or tempo features
- Program badges (Superteam, etc.)
- Ownership / ICO governance signals
For the blended final score, use /fairScore. For on-chain only, use /walletScore.
Example
curl -X GET "https://api.fairscale.xyz/socialScore?wallet=WALLET_ADDRESS&twitter=handle" \
-H "fairkey: YOUR_API_KEY"
// SDK equivalent
const { social_score } = await client.human.socialScoreOnly("WALLET_ADDRESS");
See Also
/score: full response with all 15 features and badges/fairScore: blended social + on-chain score/walletScore: on-chain score only (excludes social)