API Documentation

Authentication

All API requests require your API key in the x-api-key header.

Find your API key in Dashboard → Account.

curl -H "x-api-key: YOUR_API_KEY" \
  "https://solxray.com/api/v1/scan?mint=TOKEN_ADDRESS"

Scan Token

Returns full risk analysis for a Solana token including scores, flags, AI analysis, market data, and holder information.

Parameters

Headers

Example Request

# cURL
curl -H "x-api-key: sxr_abc123..." \
  "https://solxray.com/api/v1/scan?mint=JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN"

# Python
import requests
r = requests.get(
    "https://solxray.com/api/v1/scan",
    params={"mint": "JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN"},
    headers={"x-api-key": "sxr_abc123..."}
)
data = r.json()
print(f"Score: {data['scores']['overall']}/100")
print(f"Verdict: {data['recommendation']}")

# JavaScript
const res = await fetch(
  "https://solxray.com/api/v1/scan?mint=JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN",
  { headers: { "x-api-key": "sxr_abc123..." } }
);
const data = await res.json();
console.log(data.scores.overall, data.recommendation);

Response

{
  "token": {
    "name": "Jupiter",
    "symbol": "JUP",
    "mint": "JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN"
  },
  "scores": {
    "overall": 92,
    "rugPull": 100,
    "liquidity": 90,
    "distribution": 85,
    "activity": 88
  },
  "flags": [],
  "recommendation": "SAFE",
  "aiAnalysis": "Jupiter (JUP) shows strong fundamentals...",
  "market": {
    "priceUsd": 0.171,
    "marketCap": 610000000,
    "liquidity": 4500000,
    "volume24h": 2300000
  },
  "holders": {
    "top10": [
      { "address": "...", "amount": 1000000, "percentage": 5.2 }
    ],
    "concentration": 42.1
  }
}

Error Codes

Rate Limits

Use Cases