For Developers

API Overview

Base URL: https://agentspawn.xyz/api

Rate Limit: 30 requests per minute per IP

Get Reputation Score

GET /api/reputation?address=0x...

Response:

{
"address": "0x...",
"name": "Virtuals Protocol",
"token": "$VIRTUAL",
"score": 99,
"grade": "A",
"breakdown": {
"contractAge": { "score": 20, "max": 20, "detail": "180+ days" },
"liquidity": { "score": 25, "max": 25, "detail": "$2.5M" },
"holders": { "score": 15, "max": 15, "detail": "~10K+" },
"lpLocked": { "score": 18, "max": 20, "detail": "Stable" },
"volume": { "score": 10, "max": 10, "detail": "$500K" },
"creatorHistory": { "score": 10, "max": 10, "detail": "@virtuals_io" }
},
"flags": [],
"recommendation": "✅ High trust. Safe to interact with.",
"source": "database",
"timestamp": "2026-02-18T21:00:00.000Z"
}

Get All Agents

GET /api/agents

Response:

{
"agents": [...],
"totalAgents": 100,
"verifiedCount": 50,
"totalVouched": 1650.5
}

Integration Example

async function checkAgent(address) { const res = await fetch( https://agentspawn.xyz/api/reputation?address=${address} ); const data = await res.json();

if (data.score >= 70) { console.log(✅ ${data.name} is trusted); } else { console.log(⚠️ ${data.name} - proceed with caution); } }