🚀 Quick Start
🎭 Demo Mode (Free Testing):
• Use payment_id starting with "demo_" (e.g., demo_test_123)
• No payment required - instant testing!
💰 Production Mode:
1. Send 0.1 USDC to the service wallet on Base network
2. Use the transaction hash as payment_id
3. Call the API with your contract address
🔍 Service Discovery
GET /.well-known/ai-service.json
Returns X402 manifest with pricing and capabilities
📤 Request Format
{
"payment_id": "tx_0xYOUR_TRANSACTION_HASH",
"contract_address": "0x1234567890abcdef1234567890abcdef12345678",
"blockchain": "ethereum"
}
payment_id
required
USDC payment transaction hash (format: tx_0x...)
contract_address
required
Smart contract address to analyze (0x...)
blockchain
optional
Network: ethereum, base, bsc, polygon, or solana (default: ethereum)
📥 Response Format
{
"success": true,
"data": {
"riskScore": 0.78,
"riskCategory": "high",
"confidence": 0.92,
"features": {
"hasOwnershipTransfer": true,
"liquidityRatio": 0.23,
"giniCoefficient": 0.76,
"... 57 more features": "..."
},
"recommendation": "High risk detected. Avoid investing.",
"analysis_timestamp": "2025-10-24T02:00:00Z",
"zkml": {
"proof_id": "cc0bad36b87b96ea",
"protocol": "jolt-atlas-v1",
"verifiable": true
}
}
}