CryptoGuard

Crypto risk scanner that detected every major crash in backtesting — 27 days early, on average.

Scan any token by name, ticker, or contract address. Get a deterministic verdict: PROCEED / CAUTION / BLOCK.

Version: 0.5.0  |  Live API: https://gpartin--cryptoguard-api-fastapi-app.modal.run  |  Free tier: 5 calls/day  |  MCP: 5 tools

Backtest Results

Tested against 7 historical crypto crashes (LUNA, FTX, Celsius, 3AC, UST, SOL/FTX, TITAN) and 4 calm-market control periods. Full methodology and data: CryptoGuard backtest.

5× fewer false alarms than statistical baselines with the same recall.

Example: FTX Collapse (November 2022)

On October 16, 2022, FTT was trading at $23.73. Z-score analysis saw nothing (score 1.20, PROCEED).

CryptoGuard flagged CAUTION (anomaly score 4.72). The next day it escalated to BLOCK.

23 days later, FTX collapsed. FTT fell 94%.

Install

pip install CryptoGuardClient

Quick Start

from cryptoguard import CryptoGuardClient

client = CryptoGuardClient()

# Validate a trade — primary use case
result = client.validate_trade("bitcoin", action="buy", amount_usd=1000)
print(result["verdict"])  # PROCEED / CAUTION / BLOCK

# Scan a token
scan = client.scan("solana")
print(scan["risk_level"])

# Rug pull check
rug = client.rug_check("solana", "0xabc123...")
print(rug["risk_score"])

# Check free tier remaining
print(client.free_tier())

Primary Endpoint

curl -X POST https://gpartin--cryptoguard-api-fastapi-app.modal.run/v1/validate-trade \
  -H "Content-Type: application/json" \
  -d '{"token": "solana", "action": "buy", "amount_usd": 500}'

First 5 calls/day are free. After that: $49/mo subscription (Stripe), $0.05/call via x402 USDC, or via RapidAPI.

MCP Integration (Claude Desktop / AI Agents)

CryptoGuard is an MCP server with 5 tools. Works with Claude Desktop, Cursor, or any MCP client.

Option 1: Remote HTTP (no install)

{
  "mcpServers": {
    "cryptoguard": {
      "url": "https://gpartin--cryptoguard-api-fastapi-app.modal.run/mcp",
      "transport": "http"
    }
  }
}

Option 2: uvx

{
  "mcpServers": {
    "cryptoguard": {
      "command": "uvx",
      "args": ["--from", "CryptoGuardClient", "cryptoguard-mcp"]
    }
  }
}

Option 3: pip install

{
  "mcpServers": {
    "cryptoguard": {
      "command": "python",
      "args": ["-m", "mcp_server.server"]
    }
  }
}

MCP Tools

All Endpoints

How It Works

1. Resolves token input — CoinGecko ID, ticker symbol, or contract address (7 chains)
2. Fetches live market data from CoinGecko + DexScreener
3. Builds baseline from tier-matched peers (microcaps vs microcaps, large caps vs large caps)
4. Extracts 10 time-series features per day (price ratios, volume dynamics, momentum, volatility)
5. Runs anomaly detection — GPU-accelerated WaveGuard engine scores each token against its peer baseline
6. Multi-check pipeline: peer scan + rug pull + history + CEX/DEX spread + concentration risk
7. Returns verdict: PROCEED / CAUTION / BLOCK with anomaly scores and top contributing features

Key Features (v0.5.0)

• Backtested: 100% recall on 7 historical crashes with 27-day average lead time
• Free tier: 5 calls/day per IP, no signup required
• 3 payment options: Stripe subscription ($49/mo), x402 USDC per-scan ($0.05), or RapidAPI
• Deterministic: Same input always produces same verdict
• MCP server: 5 tools for AI agent integration (stdio + HTTP)
• Python SDK: pip install CryptoGuardClient with typed exceptions
• Contract resolution: Accepts name, ticker, or contract address across 7 chains
• Batch validation: Up to 20 trades or 50 tokens per call
• Rug pull detection: DexScreener-powered liquidity and holder analysis

Pricing

Architecture

AI Agent / User
    |
    v
CryptoGuard API (Modal, stateless)
    |-- MCP endpoint (5 tools, JSON-RPC 2.0)
    |-- Auth: API key (Stripe) → x402 (USDC) → RapidAPI → Free tier
    |-- Stripe billing (POST /v1/subscribe → checkout → API key)
    |-- Token resolution (name/ticker/address → CoinGecko ID, 7 chains)
    |-- Market data (CoinGecko + DexScreener, cached)
    +-- WaveGuard anomaly engine (GPU-accelerated)

License

MIT