RugCheck APITokensgetTokenReport

Tokens

Token Report

getTokenReportGET

This endpoint returns a full token report for a given mint. This returns quite a bit of data, organized into several sections. See the Sections below for detailed breakdown of the response structure.

Endpoint

GEThttps://api.rugcheck.xyz/v1/tokens/{id}/report

Sections

Parameters

idstring required path
Token mint address
refreshboolean optional query
Force report regeneration (paid API keys only)

Result

object

Detailed token risk report with comprehensive data organized into sections

Section I: General information

mintstring
The token mint public key
tokenProgramstring
The Token program (Token-2022 or SPL Token)
creatorstring
The public key of the token creator
creatorBalancenumber
The number of tokens the creator currently has, in lamports
tokenobject
Details on the token mint, namely:
token_extensionsobject
Token-2022 extensions. Only applicable to token-2022 tokens. These are the enabled token extensions:
tokenMetaobject
Token metadata including a boolean on whether it is mutable. Mutable metadata will trigger a minor warning
topHoldersarray
This is a list of the top holders for a token, similar in principle to the output of the RPC call getTokenLargestAccounts. It contains the following information:
freezeAuthoritystring|null
The token freeze authority, null if none. Non-null triggers warning and raises risk score substantially
mintAuthoritystring|null
The mint authority who may mint more tokens, null if none. Non-null triggers warning and raises risk score substantially
risksarray
This is a list of specific risks identified for the token in question. Each has a name, a value (can be empty), a description, a score (higher is worse), and a level (warn, danger). An example follows:
scorenumber
Raw score - sum of all weighted risks. Higher score = more risk. Minimum 1, can range into tens of millions
score_normalisednumber
Normalized score 0-100 (higher = more risk). Sigmoid function applied to raw score for UI display
fileMetaobject
Token image metadata:

Section II: Markets

lockerOwnersobject
Deprecated, returns empty object {}
lockersobject
A list of token lockers, each as follows:
marketsarray
All pools where token can be traded. Includes pools across different DEX. Each market contains:
totalMarketLiquiditynumber
USDC value of all liquidity in all markets (both sides of pools). Includes USDC decimals, not in lamports
totalStableLiquiditynumber
USDC value of stablecoin liquidity in all pools. Includes USDC decimals, not in lamports
totalLPProvidersnumber
Number of accounts providing liquidity for the token
totalHoldersnumber
Total number of accounts holding the token
pricenumber
Current price of the token in USDC
ruggedboolean
Deprecated - no longer used
tokenTypestring
Deprecated - returns empty string
transferFeeobject
Transfer fee info:
knownAccountsobject
A list of special accounts detected by RugCheck, generally the creator, pools, and lockers. An example follows:
eventsarray
This reports any changes to the mint and freeze authorities, and the supply. It does not affect the score on its own, it's only for statistical purposes. The data is returned as a list of events, containing the old values, new values and a timestamp. An example follows:
verificationobject
The verification status of the token. We previously used Jupiter's verified token system:

Section III: Insider Networks

graphInsidersDetectednumber
Number of active insider trading accounts detected for this token
insiderNetworksarray
A list with the information on each network, namely:

Section IV: Miscellaneous

detectedAtstring
Timestamp when this token was first detected
creatorTokensarray|null
Whether the creator has created other tokens. Null if there are none detected, a list otherwise. This may affect the RugCheck score heavily, if the other tokens were rug pulls. An example of the list follows. This example would generate a red 'danger' warning:
launchpadobject
Launchpad used to launch token (if any):
deployPlatformstring
Automated token launching tool detected: 'unknown', 'uxento', 'j7tracker.com', or 'rapidlaunch.io'

Code Examples

Request
Shell
curl -X GET "https://api.rugcheck.xyz/v1/tokens/TokenMintAddress/report"
Response
JSON
{
"mint": "TokenMintAddress",
"tokenProgram": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
"creator": "CreatorPublicKey",
"creatorBalance": 1000000000,
"token": {
"mintAuthority": null,
"supply": 1000000000000,
"decimals": 9,
"isInitialized": true,
"freezeAuthority": null
},
"tokenMeta": {
"name": "Token Name",
"symbol": "TKN",
"uri": "https://ipfs.io/ipfs/...",
"mutable": false
},
"topHolders": [
{
"address": "HolderAddress",
"amount": 50000000000,
"decimals": 9,
"pct": 5,
"uiAmount": 50,
"uiAmountString": "50.0",
"owner": "OwnerAddress",
"insider": false
}
],
"risks": [
{
"name": "Low Liquidity",
"value": "$2228.92",
"description": "Low amount of liquidity in the token pool",
"score": 771,
"level": "warn"
}
],
"score": 1272,
"score_normalised": 24,
"markets": [
{
"pubkey": "MarketPublicKey",
"marketType": "raydium",
"lp": {
"baseMint": "TokenMintAddress",
"quoteMint": "So11111111111111111111111111111111111111112",
"basePrice": 0.001,
"quotePrice": 100,
"lpLockedPct": 75.5
}
}
],
"totalMarketLiquidity": 50000,
"price": 0.001,
"insiderNetworks": [
{
"id": "network-identifier",
"size": 50,
"type": "trade",
"tokenAmount": 1000000,
"activeAccounts": 25
}
],
"verification": {
"jup_verified": false,
"jup_strict": false
}
}