Endpoints
Live score
/api/v1/score/:addressFull reputation read for any C-Chain address: v1 score, tier, per-signal breakdown, S4 vector (beta), graph-anomaly flags, Verified Human number.
Batch scoring
/api/v1/score/batchUp to 50 addresses per call — airdrop filtering, allowlist checks, sybil screening. Each address counts as one rate-limit unit.
Score history
/api/v1/score/:address/historyDaily snapshots for trend analysis, up to 90 days. Add include=breakdown for per-signal time series.
Machine-readable surface description at GET /api/v1 — no auth required.
Request
curl https://soci4l.net/api/v1/score/0x8ab0...1dc7 \ -H "X-Api-Key: s4_live_..."
Every response carries X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset headers.
Response
{
"address": "0x8ab0...1dc7",
"score": 43.4,
"tier": "established",
"breakdown": { "walletAge": 15, "txActivity": 10, ... },
"s4": {
"humanity": 72.1, "activity": 55.3,
"social": 38.0, "economic": 61.4,
"composite": 60.2, "confidence": 0.75
},
"graph": { "analyzed": true, "flags": [], "socialDamping": 1 },
"verifiedHuman": 2
}Rate Limits
Batch calls consume one unit per address. Limits reset on a rolling 24-hour window.
Get an API key
Keys are provisioned manually during the beta — tell us what you're building and we'll set you up. Free tier, no card.
Request a key on X