Tokens
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}/reportSections
Parameters
idstring required pathToken mint address
refreshboolean optional queryForce report regeneration (paid API keys only)
Result
objectDetailed token risk report with comprehensive data organized into sections
Section I: General information
mintstringThe token mint public key
tokenProgramstringThe Token program (Token-2022 or SPL Token)
creatorstringThe public key of the token creator
creatorBalancenumberThe number of tokens the creator currently has, in lamports
tokenobjectDetails on the token mint, namely:
token_extensionsobjectToken-2022 extensions. Only applicable to token-2022 tokens. These are the enabled token extensions:
tokenMetaobjectToken metadata including a boolean on whether it is mutable. Mutable metadata will trigger a minor warning
topHoldersarrayThis 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|nullThe token freeze authority, null if none. Non-null triggers warning and raises risk score substantially
mintAuthoritystring|nullThe mint authority who may mint more tokens, null if none. Non-null triggers warning and raises risk score substantially
risksarrayThis 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:
scorenumberRaw score - sum of all weighted risks. Higher score = more risk. Minimum 1, can range into tens of millions
score_normalisednumberNormalized score 0-100 (higher = more risk). Sigmoid function applied to raw score for UI display
fileMetaobjectToken image metadata:
Section II: Markets
lockerOwnersobjectDeprecated, returns empty object {}
lockersobjectA list of token lockers, each as follows:
marketsarrayAll pools where token can be traded. Includes pools across different DEX. Each market contains:
totalMarketLiquiditynumberUSDC value of all liquidity in all markets (both sides of pools). Includes USDC decimals, not in lamports
totalStableLiquiditynumberUSDC value of stablecoin liquidity in all pools. Includes USDC decimals, not in lamports
totalLPProvidersnumberNumber of accounts providing liquidity for the token
totalHoldersnumberTotal number of accounts holding the token
pricenumberCurrent price of the token in USDC
ruggedbooleanDeprecated - no longer used
tokenTypestringDeprecated - returns empty string
transferFeeobjectTransfer fee info:
knownAccountsobjectA list of special accounts detected by RugCheck, generally the creator, pools, and lockers. An example follows:
eventsarrayThis 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:
verificationobjectThe verification status of the token. We previously used Jupiter's verified token system:
Section III: Insider Networks
graphInsidersDetectednumberNumber of active insider trading accounts detected for this token
insiderNetworksarrayA list with the information on each network, namely:
Section IV: Miscellaneous
detectedAtstringTimestamp when this token was first detected
creatorTokensarray|nullWhether 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:
launchpadobjectLaunchpad used to launch token (if any):
deployPlatformstringAutomated token launching tool detected: 'unknown', 'uxento', 'j7tracker.com', or 'rapidlaunch.io'
Code Examples
Request
Shellcurl -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
}
}