Add AI Token Scanning
to Your Bot

# Step 1: Start the scan
POST /api/v1/scan
→ { "status": "processing", "scan_id": "abc-123", "poll_url": "...", "retry_after": 15 }

# Step 2: Poll until complete (~60s)
GET /api/v1/scan/abc-123/status
→ { "status": "complete", "data": { ...full result... } }

curl -X POST https://api.vswarm.io/api/v1/scan \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your_api_key_here" \
  -d '{
    "address": "0x532f3e7a53d2d9c07b62e684cf4f2d2b3af8f1e4",
    "chain": "base",
    "tier": "standard"
  }'

{
  "address": "0x532f3e7a53d2d9c07b62e684cf4f2d2b3af8f1e4",
  "chain": "base",
  "score": 72.0,
  "grade": "B",
  "risk_level": "MEDIUM",
  "consensus_narrative": "BRETT demonstrates strong liquidity depth on Base with a verified contract. 6 agents reached consensus with 2 debate rounds triggered on holder concentration.",
  "debates": [
    {
      "topic": "Devil's Advocate vs TechnicianBot",
      "outcome": "compromise",
      "rounds": 4
    }
  ],
  "bots": {
    "TechnicianBot": { "score": 7.8, "category": "Technical" },
    "SecurityBot":   { "score": 8.1, "category": "Safety" },
    "TokenomicsBot": { "score": 6.9, "category": "Tokenomics" },
    "SocialBot":     { "score": 7.2, "category": "Social" },
    "MacroBot":      { "score": 6.5, "category": "Macro" },
    "DevilsAdvocate":{ "score": 5.8, "category": "Adversarial" }
  },
  "scanned_at": "2026-02-28T22:00:00Z",
  "cached": false
}