FairScale API Documentation
FairScale provides trust, credit, and reputation signals for Solana wallets and AI agents. One API call returns a customisable reputation signal tuned to your use case.
Launchpads use FairScale to filter Sybils. Neobanks use it for risk assessment. DeFi protocols use it to reward real users. Agent platforms use it to gate access. The scoring layer is the same. The configuration is yours.
Two API Services
FairScale exposes two API hosts, one for each signal type:
| Service | Host | Covers |
|---|---|---|
| Agent & Credit API | https://agent-api.fairscale.xyz | Agent trust scores, trust gates, directory, credit assessments |
| Human Score API | https://api.fairscale.xyz | Human wallet scoring, FairScore, feature breakdown |
Most integrators only need the Agent & Credit API. The Human Score API is a separate service for human wallet analysis — it returns a 15-feature on-chain fingerprint (portfolio, capital flow, conviction, tempo, bot-likelihood, diversity), earned badges, and a humanity signal. See the Score Endpoint for the full schema.
Key Features
- Composable scoring. Five pillars, adjustable weights per use case. Not one-size-fits-all.
- On-chain + off-chain signals. Wallet activity, registry verification, work history, and social reputation in one call.
- Trust gates. Binary allow/deny in one request — ideal for access control.
- Credit assessments. Full underwriting opinion with lending terms and risk flags for on-chain lenders.
- Batch scoring. Score up to 25 wallets in a single request.
- Real-time. 15-minute cache; scores reflect latest on-chain state.
Quick Links
- Quick Start — first request in under a minute
- Authentication — fairkey or x402 pay-per-request
- TypeScript SDK — idiomatic client
- Solutions — integration patterns for agents, DeFi, and lending
- Examples — snippets in JS, TS, Python, cURL
Authentication
Every request uses one of two methods:
- API Key (fairkey): Pass as
fairkeyorX-Api-Keyheader. Rate-limited per plan. - x402 Micropayment: Automatic USDC payment per request via the x402 protocol. No account needed. $0.005 per trust/agent call, $0.50 per credit assessment.
See Authentication for details.
Rate Limiting
Rate limits are per-key, scaled by plan tier. See Rate Limiting.
Support
- Agent directory: agents.fairscale.xyz
- Dashboard: app.fairscale.xyz
- Sales / API keys: sales.fairscale.xyz
- x402 facilitator: dexter.cash