RugCheck API

Introduction

RugCheck is a service that provides a risk score for tokens on Solana, with a focus on memecoins.

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

This documentation will cover the different RugCheck API endpoints, as well as how to use them and interpret the response. However, if you'd like to jump right in, you can access the Swagger docs .

Free vs Paid API

Both free and paid APIs are available. The paid API has some benefits:

  1. 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.
  2. WebSocket Streaming — The paid API supports a WebSocket connection to stream token reports, for people who need the freshest possible data. View WebSocket Methods
  3. 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.xyz

Most 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.

  1. Create Account — Sign up at FluxRPC.com
  2. Generate API Key — Navigate to the RugCheck section and create an API key
  3. Use API Key — Include the API key in the X-API-KEY header or as a query parameter
See the Getting Started guide for detailed authentication instructions.

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!

Upgrade your plan in the RugCheck dashboard .

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:

T

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.

X

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.

Networks over 2,000 accounts are tracked but not returned via API to prevent data overload. Same networks often appear across multiple rug-pulls as bots reuse infrastructure.

API Endpoints

23

Tokens

9

Token Search

searchTokensGET

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

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.

Token Report Summary

getTokenReportSummaryGET

This 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

getTokenInsiderGraphGET

This 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

checkTokenEligibilityPOST

This 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

4

Vaults

2