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!
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 :)
- RugCheck API Documentation: Swagger Docs
- Post About API: x.com/Rugcheckxyz
Get started by installing via pip:
pip install rugcheck
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
Check any token with ease:
from rugcheck import rugcheck
token = '6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN'
rc = rugcheck(token)
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
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.