API Reference

The ClearChain analysis API is free and open. No API key required.

Analyze an Ethereum, Bitcoin, or Tron wallet address for AML risk. Returns a risk score, OFAC screening result, AML typologies, AI-generated narrative, and FinCEN SAR draft.

Content-Type: application/json

// Ethereum (default)
{ "address": "0x...", "chain": "ETH" }

// Bitcoin
{ "address": "bc1q...", "chain": "BTC" }

// Tron
{ "address": "T...", "chain": "TRX" }

// Also accepts ENS names:
{ "address": "vitalik.eth" }

{
  "success": true,
  "data": {
    "address": "0x722122df12d4e14e13ac3b6895a86e84145b6967",
    "chain": "ETH",
    "riskScore": {
      "total": 80,
      "level": "CRITICAL",
      "signals": [
        { "name": "ofac_match", "weight": 40, "triggered": true, "score": 40 },
        { "name": "mixer_interaction", "weight": 25, "triggered": true, "score": 25 },
        { "name": "rapid_fund_movement", "weight": 15, "triggered": true, "score": 15 },
        { "name": "high_risk_counterparty", "weight": 10, "triggered": false, "score": 0 },
        { "name": "volume_anomaly", "weight": 5, "triggered": false, "score": 0 },
        { "name": "community_red_flags", "weight": 5, "triggered": false, "score": 0 }
      ]
    },
    "typologies": [...],
    "ofacResult": {
      "matched": true,
      "matchedEntity": "Tornado Cash (OFAC SDN)",
      "confidence": 1
    },
    "analyzedAt": "2026-04-23T12:00:00.000Z"
  },
  "narrative": "On 2021-08-08, wallet 0x722... was designated...",
  "sarDraft": "SUSPICIOUS ACTIVITY REPORT — DRAFT NARRATIVE\n..."
}

Include an API key to save analyses to your dashboard and unlock higher rate limits. Generate a key in Dashboard → Settings.

curl -X POST https://clearchain.vercel.app/api/analyze \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ck_live_your_key_here" \
  -d '{"address":"0x722122dF12D4e14e13Ac3b6895a86e84145b6967"}'

Make a real request against the production API. Response time is ~8–15 seconds (includes AI generation).

curl -X POST https://clearchain.vercel.app/api/analyze \
  -H "Content-Type: application/json" \
  -d '{"address":"0x722122dF12D4e14e13Ac3b6895a86e84145b6967"}'

curl -X POST https://clearchain.vercel.app/api/analyze \
  -H "Content-Type: application/json" \
  -d '{"address":"1A1zP1eP5QGefi2DMPTfTL5SLmv7Divf5n","chain":"BTC"}'

curl -X POST https://clearchain.vercel.app/api/analyze \
  -H "Content-Type: application/json" \
  -d '{"address":"TJDENsfBJs4RFETt1X1W8wMDc8M5XnJhCe","chain":"TRX"}'