Agent AI Score Endpoint

GET /v1/score/ai

Composable trust score with custom pillar weights. Use presets for common use cases or supply your own weights for full control.

Endpoint URL

https://agent-api.fairscale.xyz/v1/score/ai?wallet=WALLET_ADDRESS

Parameters

Parameter	Type	Required	Description
`wallet`	string	Yes	Solana wallet address
`preset`	string	No	`default`, `trust_focused`, `work_focused`, `defi`, `hiring`
`verification`	number	No	Custom weight (0–1). If any pillar weight is provided, all five must be provided and sum to 1.0
`wallet_history`	number	No	Custom weight (0–1)
`work_history`	number	No	Custom weight (0–1)
`network_quality`	number	No	Custom weight (0–1)
`peer_reputation`	number	No	Custom weight (0–1)

Available Presets

Preset	verification	wallet_history	work_history	network_quality	peer_reputation
`default`	0.30	0.25	0.10	0.25	0.10
`trust_focused`	0.50	0.20	0.10	0.10	0.10
`work_focused`	0.20	0.15	0.40	0.15	0.10
`defi`	0.25	0.30	0.10	0.25	0.10
`hiring`	0.35	0.15	0.25	0.15	0.10

Example Requests

# Preset
curl "https://agent-api.fairscale.xyz/v1/score/ai?wallet=WALLET&preset=hiring" \
  -H "fairkey: zpka_your_key_here"

# Custom weights via query params
curl "https://agent-api.fairscale.xyz/v1/score/ai?wallet=WALLET&verification=0.4&wallet_history=0.2&work_history=0.2&network_quality=0.1&peer_reputation=0.1" \
  -H "fairkey: zpka_your_key_here"

Custom AI Score Endpoint

POST /v1/score/ai

Same as GET but with weights supplied in the request body. Use this for POST requests or to avoid URL length limits with custom weights.

Custom Score URL

https://agent-api.fairscale.xyz/v1/score/ai?wallet=WALLET_ADDRESS

Custom Score Parameters

Parameter	Type	Required	Description
`wallet`	string (query)	Yes	Solana wallet address

Request Body

{
  "weights": {
    "verification": 0.40,
    "wallet_history": 0.20,
    "work_history": 0.20,
    "network_quality": 0.10,
    "peer_reputation": 0.10
  }
}

Available Weight Keys

Key	Description
`verification`	Registry presence across SAID, ERC-8004, and SATI. Liveness-verified endpoints, x402 payment support, description quality.
`wallet_history`	Wallet age, transaction volume, protocol interactions, and recency. On-chain operating history.
`work_history`	Verified job completions via Kamiyo, Dexter settlement rollups, and 8004scan feedback.
`network_quality`	Quality of on-chain protocol interactions. Tier-1 DeFi protocols score higher. Funder credibility and operator trust web.
`peer_reputation`	SAID and SATI reputation scores, on-chain attestations, and organic 8004scan feedback weighted by source diversity.

Try It: Composable Scoring Playground

Drag the sliders to experiment with different pillar weights and scores. The composite score, tier, and example API call update in real time.

Composable Scoring Playground

Adjust pillar weights and scores to see how the composite FairScore is calculated in real time.

Composite Score64/ 100

Tier: GoldRecommended

Pillar Weights

Verification20%

Identity verification, KYC status, linked socials

Wallet History20%

On-chain activity, transaction patterns, wallet age

Work History20%

Completed tasks, protocol contributions, track record

Network Quality20%

Quality of connections, ecosystem participation

Peer Reputation20%

Reviews from other wallets, community standing

Pillar Scores (simulated)

Verification85

+17 pts

Wallet History70

+14 pts

Work History65

+13 pts

Network Quality58

+12 pts

Peer Reputation42

+8 pts

API Request

curl "https://agent-api.fairscale.xyz/v1/score/ai?wallet=YOUR_WALLET&preset=default" \
  -H "X-Api-Key: YOUR_KEY"

Example Response

{
  "wallet": "CNGLAYiB2B5Gzfs...",
  "score": 64,
  "tier": "gold",
  "recommendation": "recommended",
  "pillars": {
    "verification": 85,
    "wallet_history": 70,
    "work_history": 65,
    "network_quality": 58,
    "peer_reputation": 42
  },
  "preset": "default"
}