API Reference

Build on Vetted's data.

Two read-only endpoints, open access during beta — no API key required yet. Everything returns JSON.

Beta notice: these endpoints are unauthenticated and rate limits may apply informally. Don't rely on this for production traffic yet — an API key system is planned before general availability.

GET/api/v1/tokens/:address/score

Token risk score

Returns the current risk score and on-chain data for a token.

Request

curl "http://getvetted.xyz//api/v1/tokens/DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263/score"

Response

{
  "address": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
  "chain": "solana",
  "symbol": "BONK",
  "riskScore": 100,
  "liquidity": 274347.91,
  "taxBuy": 0,
  "taxSell": 0,
  "honeypot": false,
  "holderCount": 1012305,
  "lastUpdated": "2026-09-10T15:10:32.888Z"
}

Returns 404 if the token isn't tracked yet.

GET/api/v1/kols/:username/stats

KOL win-rate & calls

Returns a KOL's win-rate, average return, and recent call history.

Request

curl "http://getvetted.xyz//api/v1/kols/kol_alpha/stats"

Response

{
  "username": "kol_alpha",
  "displayName": "Alpha Caller",
  "winRate": 60,
  "avgReturn": 36,
  "totalCalls": 15,
  "updatedAt": "2026-09-10T14:00:00.000Z",
  "recentCalls": [
    { "tokenAddress": "...", "symbol": "BONK", "calledAt": "..." }
  ]
}

Returns 404 if the username isn't tracked yet.