Developer API

CryptoGuard AI API Documentation

Integrate AI-powered contract analysis, scam detection, and risk scoring into your applications. Real-time token security for your platform.

99.8%

Accuracy

<100ms

Avg Response

99.9%

Uptime SLA

Networks

Supported Networks

⟠Ethereumethereum

🟡BNB Chainbsc

🟣Polygonpolygon

🔵Arbitrumarbitrum

🔷Basebase

◎Solanasolana

🔺Avalancheavalanche

🔴Optimismoptimism

Authentication

All API requests require authentication using an API key in the x-api-key header.

x-api-key: CGAPI-XXXX-XXXX-XXXX

💡 How to get your API key: Subscribe to an API plan below. Your unique API key will be generated automatically and displayed on the success page.

Base URL

https://cryptoguardai.co/api/v1

API Endpoints

POST/api/v1/scan

Analyze a token contract for security risks including honeypot detection, ownership analysis, liquidity check, and holder distribution.

Headers

x-api-key: YOUR_API_KEY
Content-Type: application/json

Request Body

{
  "contractAddress": "0x1f9840a85d5af5bf1d1762f925bdaddc4201f984",
  "chain": "ethereum",
  "websiteUrl": "https://uniswap.org",
  "projectName": "Uniswap"
}

Response (200 OK)

{
  "status": "success",
  "scanId": "scan_abc123",
  "tokenInfo": {
    "address": "0x1f9840a85d5af5bf1d1762f925bdaddc4201f984",
    "chain": "ethereum",
    "name": "Uniswap",
    "symbol": "UNI"
  },
  "verdict": "Safe",
  "riskScore": 94,
  "analysis": {
    "honeypot": {
      "isHoneypot": false,
      "score": 98,
      "details": "No sell restrictions detected"
    },
    "ownership": {
      "renounced": true,
      "score": 100,
      "owner": "0x0000...0000"
    },
    "liquidity": {
      "totalUsd": 245000000,
      "lockedPercentage": 100,
      "lockDurationDays": 365,
      "score": 95
    },
    "holders": {
      "totalCount": 350000,
      "top10Percentage": 42.5,
      "whaleConcentration": "low",
      "score": 88
    }
  },
  "redFlags": [],
  "warnings": [],
  "scanUsage": {
    "used": 1,
    "limit": 50000,
    "remaining": 49999,
    "resetsAt": "2025-02-01T00:00:00Z",
    "isPro": true
  }
}

Error Codes

Code	Status	Description
INVALID_API_KEY	401	Missing or invalid API key
RATE_LIMIT_EXCEEDED	429	Too many requests per minute
SCAN_LIMIT_EXCEEDED	429	Monthly scan limit reached
VALIDATION_ERROR	400	Invalid request parameters
INVALID_JSON	400	Malformed JSON in request body
SCAN_ERROR	502	Error processing scan request

Rate Limits

API Starter

• 60 requests per minute
• 50,000 scans per month

API Pro

• 300 requests per minute
• 250,000 scans per month

Rate limit headers are included in every response: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset

API Pricing

Simple, transparent pricing in CAD. Cancel anytime.

API Starter

$49CAD/month

For small projects & MVPs

✓50,000 scans per month
✓60 requests per minute
✓All endpoints included
✓AI risk scoring
✓Email support

Best Value

API Pro

$149CAD/month

For growing platforms

✓250,000 scans per month
✓300 requests per minute
✓All endpoints included
✓AI risk scoring
✓Priority support
✓Webhook notifications

Need higher limits? Contact us for enterprise pricing.

Quick Start

cURL

curl -X POST https://cryptoguardai.co/api/v1/scan \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "contractAddress": "0x1f9840a85d5af5bf1d1762f925bdaddc4201f984",
    "chain": "ethereum"
  }'

Ready to Secure Your Platform?

Start integrating CryptoGuard AI into your applications today.

Back to Home