API

RESTJSON responses

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.

Base URLHTTPS
https://rugsol.xyz/api

Endpoints

POST runs a new scan. GET returns a recent one if we have it.

POST/scan
Runs a fresh scan

Description

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"
}
addressrequiredSolana token mint address (base58, 32–44 characters).

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

200Scan finished. The result is in data.
400Missing or invalid address, or the body is not valid JSON.
404GET only: no scan of this address in the last 5 minutes. Send a POST to run one.
429Scan limit reached for this client.
500The scan failed on our side. Try again in a moment.

Examples

The same request in cURL, TypeScript and Python.

cURLShell
curl -X POST https://rugsol.xyz/api/scan \ -H "Content-Type: application/json" \ -d '{"address": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263"}'
Node.js / TypeScriptfetch
const res = await fetch("https://rugsol.xyz/api/scan", { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify({ address: "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263" }), }); const { data } = await res.json(); console.log(`Score: ${data.score} | Grade: ${data.grade}`);
Python 3requests
import requests res = requests.post("https://rugsol.xyz/api/scan", json={ "address": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263" }) data = res.json()["data"] print(f"Grade {data['grade']} ({data['score']}/100)")

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.