🗺️ RugMaps — Visual Intelligence Mapping for Crypto

See through the blockchain. RugMaps reveals wallet connections, sybil clusters, and coordinated attacks that other tools miss — for free.

What It Does

RugMaps maps wallet relationships on-chain, revealing:

• 🕸️ Wallet Clusters — Groups of wallets controlled by the same entity (sybil detection)
• 🔗 Funding Trails — Common funding sources that expose coordinated launches
• 🎯 Bundle Detection — 5-signal engine that catches Jito/Flashbots bundled dumps
• 🏦 Entity Filtering — Automatically excludes Binance, Coinbase, Uniswap, and 50+ infrastructure addresses
• ⚠️ Threat Intel — Real-time checks against CryptoScamDB, GoPlus, and Januus (all free)
• 🔍 Spam Detection — 2,530+ known scam addresses + 8M spam token database

Why RugMaps?

Feature	RugMaps	BubbleMaps
Price	Free	$250/mo
Detection Methods	7 (temporal, counterparty, behavioral, funding, pattern, ML, sleeper)	1-2
Bundle Detection	✅ 5-signal engine	❌
Entity Filtering	✅ 50+ CEX/DeFi/Mixer	❌
Threat Intel	✅ CryptoScamDB + GoPlus + Januus	❌
Spam Token DB	✅ 8M+ across 6 chains	❌
GNN Fraud Scoring	✅ CPU-only ML	❌
API-First	✅ REST API	❌ Browser only
Cross-Chain	✅ Solana + Ethereum + BSC + Base	Solana only
Community Scam Database	✅ RAG memory of known scams	❌

Quick Start

# Scan a token for wallet clusters and bundles
curl -X POST http://localhost:8000/api/v1/wallet-clusters/contract-scan \
  -H "Content-Type: application/json" \
  -d '{
    "contract_address": "jtojtomepa8beP8AuQc6eXt5FriJwfFMwQx2v2f9mCL",
    "chain": "solana",
    "detect_clusters": true,
    "detect_bundles": true
  }'

Returns: holder analysis, cluster detection, bundle risk score, spam check, and GNN fraud probability — all in one call.

API Endpoints

Endpoint	What
POST /wallet-clusters/contract-scan	Full token analysis (holders + clusters + bundles + spam + GNN)
POST /wallet-clusters/cluster/detect	Cluster detection for specific wallets
POST /forensics/threat-check	Multi-source threat intel (CryptoScamDB + GoPlus + Januus)
GET /wallet-clusters/health	System status (cache, GNN, spam registry)
POST /forensics/deep-scan	Full wallet forensics
POST /forensics/cross-chain	Cross-chain wallet correlation

Detection Pipeline

Token → Filter CEX/DeFi → Check Spam Registry → Get Holders (Helius→QuickNode→DexScreener)
  → Cluster Detection (7 methods) → Bundle Detection (5 signals) → GNN Fraud Score → Risk Output

Community

• 🐦 Twitter: @cryptorugmunch
• 💬 Telegram: @rugmunchbot
• 🐛 Issues: GitHub

License

This documentation and API specification are released under CC-BY-4.0. The detection engine, algorithms, and proprietary methods are not open source.

⚠️ RugMaps is a product of Rug Munch Intelligence. The engine that powers RugMaps is proprietary and not included in this repository.