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 three 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

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

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

API Integration

Risk score is returned on all token objects. Example:

{
   "risk":{
      "rugged":false,
      "risks":[
         {
            "name":"Pump.fun contracts can be changed at any time",
            "description":"Pump.fun contracts can be changed by Pump.fun at any time",
            "level":"warning",
            "score":10
         },
         {
            "name":"Bonding curve not complete",
            "description":"No raydium liquidity pool, bonding curve not complete",
            "level":"warning",
            "score":4000
         }
      ],
      "score":3
   }
}

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

Warning Factors

Danger Factors

Liquidity Factors

Single Holder Ownership Thresholds

Group Ownership

On this page