FairScore Endpoint
GET /fairScore
Returns just the final blended FairScore as an integer (0–1000 scale). Use this when you need a quick pass/fail decision and don't care about badges, features, or pillar breakdowns.
For the full response — features, badges, tier, humanity signal — use /score instead.
Endpoint
GET https://api.fairscale.xyz/fairScore?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
{ "fair_score": 724 }
| Field | Type | Description |
|---|---|---|
fair_score | integer | Final blended FairScore on a 0–1000 scale (fairscore × 10) |
Scale Conversion
/fairScore returns the score multiplied by 10 as an integer (0–1000). The /score endpoint returns the same value on a 0–100 decimal scale. They're the same number in different units.
Example
curl -X GET "https://api.fairscale.xyz/fairScore?wallet=WALLET_ADDRESS" \
-H "fairkey: YOUR_API_KEY"
// SDK equivalent
const { fair_score } = await client.human.fairScoreOnly("WALLET_ADDRESS");
When to Use
| Need | Use |
|---|---|
| Quick allow/deny gate | /fairScore or trustGate |
| Full breakdown (features, badges, pillars) | /score |
| On-chain score only (ignore social) | /walletScore |