Risk Scores API

The Risk Score API helps assess token investment risk by evaluating multiple factors and generating a normalized risk score from 1-10. This enables users to make more informed decisions when trading tokens on Solana.

Risk Categories

Risk factors are grouped into four main categories based on severity:

Warning Factors

Potential issues that require attention but may not indicate immediate danger

Danger Factors

Significant red flags that suggest high risk or potential for malicious activity

Liquidity Factors

Issues related to token liquidity and holder concentration

Snipers & Insiders

Risks from early buyers and insider wallets

Scoring Methodology

The final risk score is normalized to a scale of 1 to 10, calculated based on the sum of individual risk factor scores (weights). Higher scores indicate higher risk.

Warning Risk Factors

These factors indicate potential concerns but may have legitimate explanations:

Risk Factor	Description	Score
No social media	Token has no associated social media links	2000
No file metadata	Token has no file metadata	100
Pump.fun contract risks	Pump.fun contracts can be changed by Pump.fun at any time	10
Incomplete bonding curve	No Raydium liquidity pool, bonding curve not complete	4000
Transitioning to Raydium	Token is currently transitioning to Raydium	100
Price decrease	Price decreased by more than 50% in the last 24 hours	1000

Danger Risk Factors

These factors indicate serious concerns that could impact token value and tradability:

Risk Factor	Description	Score
Freeze Authority Enabled	Tokens can be frozen and prevented from trading in the future	7500
Mint Authority Enabled	More tokens can be minted by the owner at any time	2500
Rugged	No liquidity, token is considered unsafe to purchase	20000
LP Burned	Allows the owner to remove liquidity at any time	4000

Dynamic Fee Risk (Meteora Curve)

For tokens on Meteora Curve with dynamic fees:

Fee Range	Level	Score
>5%	Danger	1000
>10%	Danger	1500
>20%	Danger	3000
>40%	Danger	4000
>50%	Danger	5000
>75%	Danger	7500

Liquidity Risk Factors

These factors assess token liquidity and holder concentration:

Liquidity Levels

Risk Factor	Description	Level	Score
Very Low Liquidity	The total liquidity for this token is very low	Danger	7500
Low Liquidity	The total liquidity for this token is low	Warning	5000

Holders

The following risk scores are applied based on the percentage owned by the largest holder:

Threshold	Level	Score
>90%	Danger	7000
>80%	Danger	6000
>70%	Danger	4600
>60%	Danger	4400
>50%	Danger	4300
>40%	Danger	4100
>30%	Danger	3500
>20%	Danger	2500
>10%	Danger	2000

Risk Factor	Description	Level	Score
Top 10 Holders	Top 10 holders own more than 15% of the total supply	Danger	5000

Snipers and Insiders

These factors assess the concentration of tokens held by early buyers (snipers) and insider wallets:

Snipers Risk Levels

Snipers are wallets that bought tokens within the first few transactions or blocks:

Ownership Percentage	Level	Score
>50%	Danger	10000
>30%	Danger	6000
>20%	Danger	4000
>10%	Warning	3000

Insiders Risk Levels

Insiders are wallets potentially connected to the token creators or team:

Ownership Percentage	Level	Score
>50%	Danger	10000
>30%	Danger	7000
>20%	Danger	5000
>10%	Warning	3000

API Integration

Risk score is returned on all token objects with enhanced snipers and insiders data. Example:

{
   "risk":{
      "snipers": {
         "count": 5,
         "totalBalance": 50000000,
         "totalPercentage": 12.5,
         "wallets": [
            {
               "address": "WalletAddress1...",
               "balance": 20000000,
               "percentage": 5.0
            }
         ]
      },
      "insiders": {
         "count": 3,
         "totalBalance": 30000000,
         "totalPercentage": 7.5,
         "wallets": [
            {
               "address": "WalletAddress2...",
               "balance": 15000000,
               "percentage": 3.75
            }
         ]
      },
      "top10": 25.5,
      "rugged": false,
      "risks": [
         {
            "name": "Snipers",
            "description": "Snipers own 12.50% of the total supply.",
            "value": "12.50%",
            "level": "warning",
            "score": 3000
         },
         {
            "name": "Bonding curve not complete",
            "description": "No raydium liquidity pool, bonding curve not complete",
            "level": "warning",
            "score": 4000
         }
      ],
      "score": 5,
      "jupiterVerified": false
   }
}

Risk Object Structure

The enhanced risk object now includes:

snipers: Object containing sniper wallet data
- count: Number of sniper wallets
- totalBalance: Total tokens held by snipers
- totalPercentage: Percentage of supply held by snipers
- wallets: Array of sniper wallet details
insiders: Object containing insider wallet data
- count: Number of insider wallets
- totalBalance: Total tokens held by insiders
- totalPercentage: Percentage of supply held by insiders
- wallets: Array of insider wallet details
top10: Percentage of supply held by top 10 holders
rugged: Boolean indicating if token is rugged
risks: Array of risk factors with names, descriptions, and scores
score: Normalized risk score (1-10)
jupiterVerified: Boolean indicating Jupiter verification status

Jupiter verified tokens automatically receive a risk score of 0 and have no risk factors, as they have passed Jupiter's strict verification process.

More risk factors will be added soon to improve the accuracy and comprehensiveness of the risk assessment.

Warning Factors

Danger Factors

Liquidity Factors

Snipers & Insiders

Single Holder Ownership Thresholds

Group Ownership

On this page