API Documentation

Integrate Crypto404 address scanning into your application with our REST API.

Getting Started

The Crypto404 API allows you to programmatically scan cryptocurrency addresses for security risks. All endpoints return JSON responses.

Base URL

https://crypto404.com/api

Rate Limits

100

requests / hour

Free tier

1,000

requests / hour

With API key

Unlimited

requests

Enterprise

Endpoints

POST/api/scan

Scan an address for security risks

Request Body

{

"address": string (required) - The wallet address to scan,

"blockchain": string (required) - The blockchain (ethereum, bitcoin, solana, etc.)

}

Response

{

"address": string,

"blockchain": string,

"riskLevel": safe | low | medium | high | critical,

"riskScore": number (0-100),

"flags": array of flag types,

"details": object with additional info

}

POST/api/report

Submit a report for a suspicious address

Request Body

{

"address": string (required),

"blockchain": string (required),

"flagType": string (required) - scam, phishing, hack, etc.,

"description": string (required),

"evidence": string (optional),

"email": string (optional)

}

Response

{

"success": boolean,

"reportId": string

}

GET/api/check/:address

Quick check if an address is flagged

Parameters

address: string - The wallet address

chain: string (query param) - The blockchain

Response

{

"flagged": boolean,

"riskLevel": string,

"flagCount": number

}

Code Examples

JavaScript

const response = await fetch('https://crypto404.com/api/scan', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': 'your-api-key' // Optional
  },
  body: JSON.stringify({
    address: '0x742d35Cc6634C0532925a3b844Bc9e7595f8bDe8',
    blockchain: 'ethereum'
  })
});

const result = await response.json();
console.log(result.riskLevel); // 'safe' | 'low' | 'medium' | 'high' | 'critical'

Need Higher Limits?

Contact Sales