REST API

API Documentation

Integrate CryptoGuard wallet scanning into your application. Scan wallets, check risk scores, and monitor addresses programmatically.

Read-Only API — No Wallet Connection Required

CryptoGuard is a read-only scanning tool. We never ask for private keys, seed phrases, or wallet signatures. Our API only accepts public wallet addresses — the same addresses visible on any block explorer. We cannot access, move, or modify any funds. Your assets are always safe.

Quick Start

1. Get your token

curl -X POST https://cryptoguard-backend-production-96ac.up.railway.app/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email":"you@email.com","password":"yourpass"}'

2. Scan a wallet

curl https://cryptoguard-backend-production-96ac.up.railway.app/scan/0x742d35Cc...?chain_id=1 \
  -H "Authorization: Bearer YOUR_TOKEN"

Base URL

https://cryptoguard-backend-production-96ac.up.railway.app

All endpoints are relative to this base URL. Authenticated endpoints require a Bearer token in the Authorization header.

Endpoints

POST/auth/register

Create a new account

Request body

{ "email": "user@example.com", "password": "min8chars" }

Response

{ "access_token": "eyJ...", "token_type": "bearer" }
POST/auth/login

Login and get access token

Request body

{ "email": "user@example.com", "password": "password" }

Response

{ "access_token": "eyJ...", "token_type": "bearer" }
GET/scan/{address}?chain_id=1Auth required

Scan a wallet for security risks across 23+ blockchains

Response

{ "wallet_address": "0x...", "risk_score": 72, "risk_level": "HIGH", "flags": ["[GoPlus] Address linked to phishing"], "etherscan_summary": { "tx_count": 150, "balance_eth": 1.25 }, "data_sources": ["OFAC", "GoPlus", "Etherscan", "CheckCryptoAddress", "ScamSearch"] }
GET/scan/token/{contract}?chain_id=1Auth required

Scan a token contract for honeypots, rug pulls, hidden taxes, and blacklist functions

Response

{ "contract_address": "0x...", "token_name": "Example", "token_symbol": "EX", "risk_score": 45, "risk_level": "HIGH", "flags": ["[DANGER] Honeypot token"], "details": { "is_honeypot": "1", "buy_tax": "0.05", "sell_tax": "0.15" } }
GET/scan/nft/{contract}/{token_id}?chain_id=1Auth required

Scan an NFT for contract security, ownership, rarity, and floor price

Response

{ "contract_address": "0x...", "token_id": "1234", "name": "NFT #1234", "collection": "Collection Name", "risk_score": 0, "risk_level": "LOW", "flags": ["[SAFE] No security risks detected"] }
POST/scan/batchAuth required

Batch scan up to 500 wallets (Enterprise only)

Request body

{ "wallets": [{ "address": "0x...", "chain_id": 1 }, { "address": "0x...", "chain_id": 56 }] }

Response

{ "total": 2, "scanned": 2, "results": [{ "wallet_address": "0x...", "risk_score": 15, "risk_level": "LOW", "flags": [] }] }
GET/scan/history/meAuth required

Get your scan history (last 50 scans)

Response

[{ "id": 1, "wallet_address": "0x...", "risk_score": 72, "risk_level": "HIGH", "flags": [...] }]
POST/monitorAuth required

Add a wallet to 24/7 monitoring with email alerts

Request body

{ "wallet_address": "0x...", "chain_id": 1, "last_risk_score": 72, "last_risk_level": "HIGH" }

Response

{ "id": 1, "wallet_address": "0x...", "alert_on_movement": true }
GET/billing/statusAuth required

Get your current plan and usage

Response

{ "plan": "free", "scans_per_day": 3, "scans_today": 1 }

Rate Limits

Free

5 scans/day

Pro

Unlimited

Enterprise

Unlimited + Priority

Ready to integrate?

Create a free account to get your API token and start scanning wallets programmatically.

Get API access