RugCheck API
Introduction
Overview
The risk score is calculated from many different data sources. For transparency, a full report is available that breaks down key risks, and provides an overview of the token.
RugCheck has no token of its own, applies the same algorithm to all tokens, and is free to use. You can run a report for any token yourself on the RugCheck website.
Quick Start
Free vs Paid API
Both free and paid APIs are available. The paid API has some benefits:
- Fresh Reports — To deal with request volume, the free API needs to cache token reports. On the paid API you can request a fresh report at any time.
- WebSocket Streaming — The paid API supports a WebSocket connection to stream token reports, for people who need the freshest possible data. View WebSocket Methods
- Higher Rate Limits and Bulk Reports — The paid API allows more requests per second. You can also request up to 255 token reports at once.
Pricing Plans
Bundle
Basic (Bundle)
$12/mo
10 RPS, 20 API keys
Monthly
Basic
$40/mo
10 RPS, 20 API keys
Business
$100/mo
100 RPS, 20 API keys
Pro
$500/mo
500 RPS, 20 API keys
Yearly
Basic (Yearly)
$360/yr
10 RPS, 20 API keys
Business (Yearly)
$900/yr
100 RPS, 20 API keys
Pro (Yearly)
$4,500/yr
500 RPS, 20 API keys
RugCheck API Endpoint
https://api.rugcheck.xyzMost endpoints are free. For paid features and higher rate limits, create an account at FluxRPC and generate an API key.
Risk Analysis
Comprehensive token risk scoring and breakdown
Insider Detection
Identify wash trading and fake holder networks
Fresh Data
Real-time reports with paid plans, cached for free tier
Authentication
Most endpoints are public and don't require authentication. For paid features and higher rate limits, create a free account at FluxRPC.com and generate an API key.
- Create Account — Sign up at FluxRPC.com
- Generate API Key — Navigate to the RugCheck section and create an API key
- Use API Key — Include the API key in the
X-API-KEYheader or as a query parameter
Rate Limits & Plans
Free Plan
Cached Data
Reports are cached. Limited requests per second.
No Bulk Data
Only access reports one-at-a-time.
All Paid Plans
Fresh Reports
Request fresh data anytime. Higher rate limits.
Websockets
Get token reports streamed to you.
Bulk Reports
Fetch up to 255 token reports at once.
Business Plan or Higher
All Paid plan benefits plus:
Insider Network Websocket
Receive insider network detection events the moment they happen!
Understanding Risk Scores
RugCheck analyzes tokens across multiple dimensions to calculate a risk score. Lower scores indicate safer tokens. Reports include two values: score — the raw, unbounded sum of all detected risks — and score_normalised — the same score mapped onto a 0-100 scale, which is what most UIs display.
Good — score < 1,000 (normalised < ~21)
Low risk. Token passes most safety checks with minimal concerns.
Warning — score 1,000-5,000 (normalised ~21-40)
Moderate risk. Some concerning indicators present. Review carefully.
Danger — score > 5,000 (normalised > ~40)
High risk. Multiple red flags detected. Exercise extreme caution.
Insider Networks Explained
RugCheck detects sophisticated insider trading patterns by analyzing on-chain relationships between accounts. Two main network types are identified:
Trade Networks (Wash Trading)
Multiple accounts controlled by a single owner trading back-and-forth to create the illusion of healthy trading volume. Often uses intermediary accounts to obfuscate fund sources.
Transfer Networks (Fake Holders)
Coordinated attempts to artificially inflate holder count by transferring large amounts to many controlled accounts. Typically 0.5%+ of supply to 100+ accounts — not airdrops.
API Endpoints
23General
3Service Health Check
pingGETCheck if the RugCheck API service is running. Returns 'pong' if the service is operational. This endpoint will fail to return if RugCheck is under maintenance.
User Leaderboard
getLeaderboardGETGet user leaderboard rankings
Maintenance Status
getMaintenanceGETCheck maintenance status and accessibility. Returns HTTP 200 if RugCheck is running and accessible, returns another status code otherwise. This endpoint does not return any data payload.
Tokens
9Token Search
searchTokensGETFull-text search over token name, symbol and mint address. Results come back ranked, with legitimate tokens ahead of the impersonators that copy their name, so the array order can be rendered as-is. Passing no query returns trending tokens.
Token Report
getTokenReportGETThis 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.
Token Report Summary
getTokenReportSummaryGETThis endpoint returns a summary of the report for the requested token. It's much shorter than the full report.
Report a Token
reportTokenPOST Auth This endpoint is deprecated, it doesn't do anything on the current version of RugCheck. Some previous versions of RugCheck had community verification features.
Token Insider Graph
getTokenInsiderGraphGETThis endpoint returns a detailed report on insider networks discovered for a given token, suitable for display or analysis. For only a summary of insider trading activity, it's better to use the token report endpoint . This endpoint can return a lot of data in some cases. Occasionally, insider networks may contain 20,000 accounts or more. There are some limits in place to prevent very large insider networks from returning an overwhelming amount of data — this endpoint won't return networks over 2000 accounts in size. We still track these larger networks and their activity, and they still generate warnings in the token report.
Bulk Token Reports
bulkTokenReportsPOST Auth This endpoint will return a list of token reports, when provided with a list of token mints. This feature requires a paid RugCheck plan. You may request token reports for up to 255 tokens at once. The data returned from this endpoint may always be cached. Even for paid API plans, there is no way to force bulk report re-generation, for performance reasons. For guidance on interpreting token reports, see the Get a Token Report section.
Bulk Token Summary
bulkTokenSummaryPOST Auth Given a list of token mints, this endpoint returns a list of summarized token reports. This feature requires a paid RugCheck plan. These may be served from cache, for performance reasons. You may request token reports for up to 255 tokens at once. For examples on how to interpret these reports, see the Get a Token Summary section.
Token Domain Eligibility
checkTokenEligibilityPOSTThis endpoint will verify if a token is eligible for a 'Verified by RugCheck' .token domain. Tokens must meet some scoring requirements before we'll provide a transaction for you to sign in order to secure a .token domain. Note: Generally, it's not expected that you use this endpoint programatically. It's intended to be used from the RugCheck Website .
Verified Token List
getAllVerifiedTokensGET Auth Lists tokens verified directly through RugCheck, newest verification first. This endpoint requires a paid RugCheck API key and uses cursor pagination. Start without a cursor. When a response includes nextCursor , pass that exact value as cursor on the next request. If nextCursor is omitted, you have reached the final page.
Statistics
4New Tokens
getNewTokensGETThis returns a list of recently detected tokens. The response includes mint, decimals, symbol, creator, mintAuthority, freezeAuthority, program, createAt, updatedAt, and events fields for each token.
Most Viewed Tokens
getRecentTokensGETThis returns the most viewed tokens on RugCheck, in the last 24 hours. The response includes mint, metadata (name, symbol, uri, mutable, updateAuthority), user_visits, visits, and score for each token.
Trending Tokens
getTrendingTokensGETThis endpoint returns the most 'voted for' tokens on RugCheck, in the last 24 hours. The voting feature is purely cosmetic, and does not factor into scoring. Response includes mint, vote_count, and up_count for each token.
Recently Verified Token Stats
getVerifiedTokensGETThis endpoint returns statistical information on the most recently verified tokens. These are tokens that have purchased a .token domain. Response includes mint, payer, name, symbol, description, jup_verified, jup_strict, and links for each token.
Domains
2Verified .token Domains
getDomainsGETThis endpoint returns the .token domains that have been verified at RugCheck. These verified domains must meet some requirements to be registered — tokens that score poorly are blocked from registration. The endpoint is paginated. It accepts the following parameters: • page - The page of the data you wish to receive • limit - The number of items per page • verified - A boolean, true if you only want tokens with verified domains, false if you want to return all tokens. You would almost always want to set this to true when using this endpoint.
Domain Lookup
lookupDomainGETThis endpoint accepts a token domain as a string, and returns the string of the token mint's base58-encoded public key. The output is simply the public key as a string.
Vaults
2Token Locker Vaults
getTokenLockersGET Auth This endpoint returns the amount and value of any locked LP tokens for the supplied token mint. These locked LP tokens cannot be accessed by the owner until the unlock date has passed. Important: Locked LP tokens factor heavily into RugCheck scoring — new tokens with little or no LP locked will tend to be flagged as possible rug pulls.
FluxBeam Locker Vaults
getFluxLockersGET Auth This returns only LP tokens locked in the FluxBeam Locker. It functions the same as Get Locker Vaults for Token , except that it will only return vaults belonging to the FluxBeam Locker. This was built for internal use. Generally, you will want to use the Get Locker Vaults for Token endpoint. Important Note: The total field returned by this endpoint is the sum of all token lockers , not just Fluxbeam ones.
Votes
2Submit Token Vote
submitTokenVotePOSTThis submits a vote for the current token. This feature is purely cosmetic and does not affect scoring. The endpoint accepts only a token mint. Note: This endpoint is not intended to be used programmatically.
Token Votes
getTokenVotesGETThis is a purely cosmetic feature, it does not affect token scoring. This endpoint will get the community votes for a token, given the mint. Response includes: • up - number of upvotes • down - number of downvotes • userVoted - whether the currently logged in user has already voted