Skip to content

ccan23/rugcheck

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

RugCheck

RugCheck

This is an unofficial but simple and super easy-to-use Python wrapper for rugcheck.xyz.

If you’ve been around DEXs, you know the scams, rug pulls, and sudden liquidity losses. This wrapper lets you automate token risk checks, potentially saving your wallet before it’s too late.

RugCheck doesn’t promise you Lambos or moonshots, but it can help you avoid disasters. Use it as one part of your research arsenal.

Stay safe and happy trading!

⚠️ Disclaimer

I'm just the messenger here. This project only gives you what RugCheck reports so what they report is what you get. If they mess up or miss a rug, I'm not responsible! So please DYOR and stay cautious :)

📚 Helpful Links

📥 Installation

Get started by installing via pip:

pip install rugcheck

🚀 How to Use It

Using the Command-Line Interface (CLI)

After installation, you can use the rugcheck command directly in your terminal to get quick summary.

rugcheck <token_address>

Example:

rugcheck 6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN

Output:

Name: OFFICIAL TRUMP (TRUMP)
Rugged: No
Result: Danger
Risk Score: 18715
Mint Address: 6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN
Total Market Liquidity: $458,448,342.48

Risks:
  - Top 10 holders high ownership (Level: danger, Score: 9296)
    Description: The top 10 users hold more than 70% token supply
  - Single holder ownership (Level: danger, Score: 8000)
    Description: One user holds a large amount of the token supply
    Value: 80.00%
  - High ownership (Level: danger, Score: 1419)
    Description: The top users hold more than 80% token supply

Links:
  No links provided.

Detected At: 2025-01-17T14:27:21.13275916Z

Using It as a Python Module

Check any token with ease:

from rugcheck import rugcheck

token = '6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN'
rc = rugcheck(token)

🔑 What’s Inside?

You get all the token details found on the RugCheck website and more. Access them using JavaScript-style dot notation or Python’s classic get() method:

rc.creator                rc.get(                   rc.lockers                rc.result                 rc.to_dict()              rc.tokenType              rc.totalMarketLiquidity   
rc.detectedAt             rc.graphInsiderReport     rc.markets                rc.risks                  rc.to_json()              rc.token_address          rc.transferFee            
rc.events                 rc.graphInsidersDetected  rc.mint                   rc.rugged                 rc.token                  rc.token_extensions       rc.verification           
rc.fileMeta               rc.knownAccounts          rc.mintAuthority          rc.score                  rc.tokenMeta              rc.topHolders             
rc.freezeAuthority        rc.lockerOwners           rc.print_summary(         rc.summary                rc.tokenProgram           rc.totalLPProviders 

📦 Want to See Everything?

Export the entire token data easily:

  • As a python dictionary: rc.to_dict()
  • As a JSON string: rc.to_json()

You can check samples/response.json for the full response to see what data you can expect.

📬 Contact

[email protected]