API
Run the same scan the website runs from your own bot or dashboard. One endpoint, one JSON response.
Base URL
All endpoints live under this path.
Endpoints
POST runs a new scan. GET returns a recent one if we have it.
/scanDescription
Scans a Solana token address. Returns the score (0–100), grade (A–F), every flag with its point cost, and the raw result of each check: mint and freeze authority, sell check, liquidity, holders, metadata, token age and price. To fetch a scan from the last 5 minutes without running a new one, call GET /scan?address=….
Request body (application/json)
{
"address": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263"
}Sample response (200, trimmed)
{
"success": true,
"cached": false,
"data": {
"tokenAddress": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
"scanMode": "dex",
"score": 90,
"grade": "A",
"gradeLabel": "Safe",
"penalties": [
{ "category": "Top Holder Risk", "reason": "Elevated concentration (Top 10 hold 31.2%) (Largest: 8.4%)", "points": 10 }
],
"totalPenalties": 10,
"checks": {
"mintAuthority": { "status": "success", "data": { "status": "pass", "value": "Revoked" } },
"freezeAuthority": { "status": "success", "data": { "status": "pass", "value": "Revoked" } },
"honeypot": { "status": "success", "data": { "isHoneypot": false, "simulationSuccess": true } },
"holders": { "status": "success", "data": { "topTenPercent": 31.2 } },
"liquidity": { "status": "success", "data": { "lpSizeUsd": 4200000, "lpBurned": false } }
},
"scannedAt": "2026-02-08T12:00:00.000Z"
}
}Status codes
Examples
The same request in cURL, TypeScript and Python.
Limits and caching
How often you can scan, and when you get a stored result.
429
Returned when this client hits its scan limit
5 min
How long GET can return a stored scan
POST
Always runs a new scan
Paid API plans with higher limits are not available yet.
Good to know
How results behave when something upstream is slow or missing.
Cached results
GET returns cached: true with a scan from the last 5 minutes. POST returns cached: false.
Partial results
If one check fails, the rest still return. That check comes back with status "error" or "unknown" and data: null.
Holder data
Holders come from the largest token accounts on-chain. LP pool accounts are marked and left out of the concentration numbers.