RugCheck — Solana Token Risk Analysis

Analyze any Solana token by mint address using the free RugCheck API. No API key required for read endpoints.

Quick Start

# Get risk summary (score + flags)
bash scripts/rugcheck.sh summary <MINT_ADDRESS>

# Get full detailed report (holders, markets, metadata, LP)
bash scripts/rugcheck.sh report <MINT_ADDRESS>

Script Reference

Run bash scripts/rugcheck.sh help for all commands:

Interpreting Results

Summary Response

Key fields from /v1/tokens/{mint}/report/summary:

• score_normalised — Risk score 0-100. Higher = riskier. Below 1000 raw score ≈ "Good".
  • 0-30: Low risk (Good)
  • 30-60: Medium risk (caution)
  • 60-100: High risk (danger)
• risks[] — Array of risk flags, each with:
  • name: Risk type (e.g. "Mutable metadata", "Low Liquidity", "Single holder ownership")
  • level: "warn" or "danger"
  • value: Human-readable detail (e.g. "$102.55", "40.00%")
  • description: Explanation
  • score: Raw risk contribution
• lpLockedPct — Percentage of LP tokens locked (0 = none locked, very risky)
• tokenProgram — SPL token program used
• tokenType — Token type classification

Full Report Response

Additional fields from /v1/tokens/{mint}/report:

• tokenMeta — Name, symbol, URI, mutable flag, updateAuthority
• token — Supply, decimals, mintAuthority, freezeAuthority
• creator / creatorBalance — Token creator wallet and their current balance
• topHolders[] — Top holders with address, owner, pct (percentage), uiAmount
• markets[] — DEX markets/pools with liquidity data
• insiderNetworks — Connected insider wallet clusters

Red Flag Checklist

When analyzing a token, flag these risks to the user:

1. Mutable metadata (tokenMeta.mutable == true) — Creator can change token name/image
2. Low liquidity (risk with "Low Liquidity" or check market data) — Easy to manipulate price
3. High holder concentration — Top 10 holders > 50% supply
4. Single holder dominance — One wallet holds >20% supply
5. LP not locked (lpLockedPct == 0) — Creator can pull liquidity anytime
6. Mint authority exists (token.mintAuthority != null) — Can mint infinite tokens
7. Freeze authority exists (token.freezeAuthority != null) — Can freeze wallets
8. Few LP providers — Only 1-2 wallets providing liquidity
9. Low/zero trade volume — No real market activity
10. Creator holds large balance — Creator still sitting on supply

Presenting Results

Format findings clearly for the user. Example:

🔍 RugCheck Analysis: CLWDN (ClawdNation)
Mint: 3zvSRWfjPvcnt8wfTrKhgCtQVwVSrYfBY6g1jPwzfHJG

⚠️ Risk Score: 59/100 (Medium-High Risk)

🚩 Risk Flags:
  🔴 Low Liquidity — $102.55
  ⚠️ Single holder ownership — 40.00%
  ⚠️ High holder concentration — Top 10 hold >50%
  ⚠️ Low amount of holders
  ⚠️ Low LP providers
  ⚠️ Mutable metadata

🔓 LP Locked: 0% (NOT LOCKED)

📊 Top Holders:
  1. 40.0% — 3Y3g...p7rk
  2. 15.0% — 5bNH...4VGj
  3. 15.0% — 4dkX...Ncg6
  4. 10.0% — 8yY2...CKn8
  5. 10.0% — 2MT5...eB3h

Verdict: HIGH RISK — Multiple red flags. No locked liquidity,
concentrated holdings, mutable metadata. Exercise extreme caution.

API Details

• Base URL: https://api.rugcheck.xyz
• Auth: None required for read endpoints
• Rate limits: Respect 429 responses; add 2-3 second delays between bulk queries
• RugCheck web: https://rugcheck.xyz/tokens/<mint> (link for users)

Bulk Queries (requires auth)

These endpoints need a JWT from Solana wallet auth — not available for most agents:

• POST /v1/bulk/tokens/summary — Check multiple tokens at once
• POST /v1/bulk/tokens/report — Full reports for multiple tokens