gpartin/CryptoGuardClient

**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.6.0  |  **Live API**: https://gpartin--cryptoguard-api-fastapi-app.modal.run  |  **Free tier**: 5 calls/day  |  **MCP**: 7 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.
| Method | Recall | Avg Lead Time | False Positive Rate |
|--------|--------|---------------|---------------------|
| **CryptoGuard (WaveGuard engine)** | **100% (7/7)** | **27.4 days** | **6.1%** |
| Z-score baseline | 100% (7/7) | 28.4 days | 29.9% |
| Rolling volatility | 86% (6/7) | 15.5 days | 4.0% |
**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
Quick Start
Primary Endpoint
First 5 calls/day are free. After that: **$0.05/call** via x402 USDC, or via RapidAPI.
MCP Integration (Claude Desktop / AI Agents)
CryptoGuard is an MCP server with 7 tools. Works with Claude Desktop, Cursor, or any MCP client.
Option 1: Remote HTTP (no install)
Option 2: uvx
Option 3: pip install
MCP Tools
| Tool | Description |
|------|-------------|
| cryptoguard_validate_trade | Validate a trade → PROCEED / CAUTION / BLOCK |
| cryptoguard_scan_token | Anomaly scan for any token |
| cryptoguard_validate_trade_plus | Premium stateless decision bundle with what-if analysis |
| cryptoguard_counterfactual_trade | What-if sensitivity analysis with tipping-point guidance |
| cryptoguard_rug_check | DEX pair rug pull risk assessment |
| cryptoguard_search | Search tokens by name/symbol/address |
| cryptoguard_health | Service health check |
All Endpoints
| Method | Endpoint | Price | Description |
|--------|----------|-------|-------------|
| POST | /v1/validate-trade | 5 free/day, then $0.05 | **Primary** — single verdict for AI agents |
| POST | /v1/validate-trades | 5 free/day, then $0.05 | Batch validate up to 20 trades |
| GET | /v1/scan/{coin_id} | 5 free/day, then $0.05 | Single token anomaly scan |
| POST | /v1/portfolio/scan | 5 free/day, then $0.05 | Portfolio batch scan (up to 50 tokens) |
| GET | /v1/scan/{coin_id}/history | 5 free/day, then $0.05 | Historical self-comparison |
| GET | /v1/rug-check/{chain}/{pair_address} | 5 free/day, then $0.05 | Rug pull risk assessment |
| GET | /v1/dex/new-pairs | 5 free/day, then $0.05 | New DEX pair discovery |
| GET | /v1/dex/search | 5 free/day, then $0.05 | DexScreener pair search |
| GET | /v1/dex/pair/{chain}/{pair_address} | 5 free/day, then $0.05 | DEX pair details |
| GET | /v1/dex/token/{token_address} | 5 free/day, then $0.05 | DEX token info |
| POST | /v1/intel/validate-trade-plus | $0.10/call | Premium stateless decision bundle |
| POST | /v1/intel/counterfactual-trade | $0.08/call | What-if sensitivity analysis |
| GET | /v1/track-record | Free | Historical prediction track record |