GET /v1/score
Composite trust score (0-100) with five pillar subscores, badges, and registry signals.
Quick start: Quick Start: Agent Trust.
Endpoint
GET https://agent-api.fairscale.xyz/v1/score?wallet=WALLET_ADDRESS
| Parameter | Type | Required | Description |
|---|---|---|---|
wallet | string | Yes | Solana wallet address |
task | string | No | defi_execution, trust_focused, work_focused, hiring |
| Header | Required | Description |
|---|---|---|
fairkey | Yes | API key |
Example
curl "https://agent-api.fairscale.xyz/v1/score?wallet=FRGumQszUGLTtfgH3gDwzG256pL4P8Cj3DDGAPCmBFka" \
-H "fairkey: YOUR_KEY"
Verified response (Jul 2026):
{
"wallet": "FRGumQszUGLTtfgH3gDwzG256pL4P8Cj3DDGAPCmBFka",
"score": 24,
"tier": "bronze",
"recommendation": { "tier": "unverified", "label": "Unverified", "color": "red" },
"pillars": {
"verification": 29,
"wallet_history": 63,
"work_history": 0,
"network_quality": 0,
"peer_reputation": 0
},
"signals": {
"fairscore_base": 39,
"is_registered": false,
"is_verified": false
},
"badges": [{ "id": "superteam", "label": "Superteam", "tier": "platinum" }],
"meta": { "scored_at": "2026-07-04T15:01:41.249Z", "from_cache": false }
}
Key fields
| Field | Notes |
|---|---|
score | 0-100 composite agent trust score |
tier | bronze, silver, gold, platinum |
pillars | verification, wallet_history, work_history, network_quality, peer_reputation |
signals.is_registered | Present on agent registry |
signals.is_verified | Liveness-verified endpoint |
badges | On-chain behaviour badges (may overlap human score badges) |
meta.from_cache | true if served from 15 min cache |
Pillar definitions: Scoring Model.
Related
- Trust Gate: binary allow/deny
- Composable Score: custom pillar weights
- Batch scoring: up to 25 wallets per request
- Agent Profile: registry metadata + full breakdown