API Documentation

{
  "success": true,
  "data": {
    "token": {
      "mint": "ExAmPLetOkEnaDDrEsSFoRDoCsOnLypump",
      "name": "Example Token",
      "symbol": "EXAMPLE"
    },
    "cohort": "canonical",
    "canonicalRugScore": {
      "level": "HIGH",
      "normalized": 67,
      "levelDescription": "Multiple rug indicators detected — majority of tokens with this profile were rugged",
      "signals": [
        {
          "name": "BUY_SELL_RATIO",
          "description": "Buy-heavy trading activity detected",
          "active": true
        },
        {
          "name": "LOW_ACTIVITY",
          "description": "Low early trading activity",
          "active": false
        },
        {
          "name": "SERIAL_RUGGER",
          "description": "Deployer has a history of failed token launches",
          "active": false
        },
        {
          "name": "HIGH_MCAP",
          "description": "Token already reached significant market cap before scan",
          "active": false
        }
      ],
      "signalsFired": ["BUY_SELL_RATIO"]
    },
    "canonicalPeakScore": {
      "label": "MODERATE_SETUP",
      "labelDescription": "Some favorable conditions present",
      "pumpRate": 0.31,
      "avgMultWhenPumps": 5.25,
      "sampleSize": 1163,
      "signals": [
        {
          "name": "MCAP_WINDOW",
          "description": "Market cap between $50K–$250K at scan time"
        }
      ],
      "signalsFired": ["MCAP_WINDOW"]
    },
    "scanConditions": {
      "marketCapAtScan": 63395,
      "bundleRate": 46,
      "buySellRatio": "4.0:1",
      "totalTransactions5m": 1778,
      "volume5m": 49626.43,
      "scanTimestampUtc": "2026-04-28T02:52:32.670Z"
    },
    "behavioralProfile": {
      "walletAgeProfile": 2,
      "buyerTrackRecord": 5,
      "holderConcentration": 40,
      "fundingConnections": 0,
      "walletClustering": 100
    },
    "trajectoryPrediction": {
      "cohortKey": "sub-65_serial",
      "cohortSize": 1625,
      "confidence": "high",
      "stale": false,
      "priceTrajectory": {
        "multiplier1h": {
          "median": 0.717,
          "p25": 0.220,
          "p75": 1.391
        },
        "multiplier6h": {
          "median": 0.120,
          "p25": 0.044,
          "p75": 0.661
        },
        "pctPumpedOver1_5x": 21.2,
        "pctCrashedBelow0_5x": 40.1
      },
      "outcomeDistribution": {
        "RUGGED": 72.4,
        "DUMPED": 4.6,
        "LIQUIDITY_PULL": 3.9,
        "STABLE": 1.8,
        "DECLINED": 1.7,
        "PUMP_AND_DUMP": 1.7,
        "GREW": 1.5,
        "DEAD": 0.4
      },
      "avgTimeToRug": 2957
    },
    "postScanTrajectory": {
      "status": "CONFIRMED",
      "computedAt": "2026-04-28T03:22:32.717Z",
      "minutesPostScan": 47,
      "mcapShape": {
        "check1": 96167,
        "check6": 130564,
        "ratio": 1.358,
        "classification": "ok"
      },
      "volumeShape": {
        "check1": 47860,
        "check6": 53319,
        "ratio": 1.114,
        "classification": "ok"
      },
      "historicalContext": {
        "crashRate": 0.063,
        "pumpRate": 0.491,
        "sampleSize": 1180,
        "cohortLabel": "mcap_ok + vol_ok"
      }
    },
    "deployerProfile": {
      "address": "BnnNJJgy9w2MLQ9XBKJKG9FQa2r9qdW7u5VpzEkwUcc3",
      "type": "serial",
      "totalTokens": 1440,
      "outcomes": {
        "rugged": 534,
        "dead": 16,
        "stable": 8,
        "grew": 10,
        "unknown": 872
      },
      "rugRate": 0.94,
      "riskAssessment": "SERIAL_RUGGER"
    },
    "walletIntelligence": {
      "buyerComposition": {
        "totalBuyers": 50,
        "coverageRate": 100,
        "reputationBreakdown": {
          "orchestrators": 1,
          "victims": 0,
          "knownGood": 0,
          "neutral": 49,
          "unknown": 0
        },
        "avgReputationScore": 51,
        "pnlProfile": null
      },
      "fundingPattern": {
        "classification": "DEEP_SHARED",
        "sharedFunderCount": 10,
        "linkedBuyerCount": 25,
        "description": "Deep funding network: 10 shared funder(s) linking 25 of 50 buyers",
        "funders": [
          {
            "address": "5Ww9G6...U25H",
            "buyersFundedInToken": 19,
            "totalTokensFunded": 111,
            "rugRate": 1.0,
            "reputationLevel": "KNOWN_ORCHESTRATOR",
            "isCabalMember": false,
            "cabalId": null
          }
        ]
      }
    },
    "cabalPresence": {
      "detected": true,
      "summary": {
        "uniqueCabals": 7,
        "totalMembersFound": 7,
        "highestRugRate": 0.877,
        "dominantArchetype": "EVOLVING_FLEET",
        "dominantActivityStatus": "ACTIVE",
        "fundingTraceability": "MEDIUM"
      },
      "cabals": [
        {
          "cabalId": "CAB-81DC0E14919E0553",
          "rugRate": 0.877,
          "archetype": "EVOLVING_FLEET",
          "memberCount": 421,
          "totalTokens": 2448,
          "activityStatus": "ACTIVE",
          "fundingTraceability": "HIGH",
          "membersFoundInToken": 1
        }
      ]
    },
    "meta": {
      "scannedAt": "2026-04-28T02:52:32.670Z",
      "dataAge": "47 min",
      "pipelineVersion": "4.4.1",
      "plan": "business",
      "datasetSize": 21698
    }
  },
  "meta": {
    "timestamp": "2026-04-28T03:39:11.311Z"
  }
}

{
  "success": true,
  "data": {
    "mint": "ExAmPLetOkEnaDDrEsSFoRDoCsOnLypump",
    "status": "pending",
    "message": "Token discovered, scan in progress",
    "discoveredAt": "2026-04-28T14:20:00.000Z"
  },
  "meta": {
    "timestamp": "2026-04-28T14:20:01.000Z"
  }
}

{
  "success": true,
  "data": {
    "mint": "ExAmPLetOkEnaDDrEsSFoRDoCsOnLypump",
    "status": "not_found",
    "reason": "not_discovered"
  },
  "meta": {
    "timestamp": "2026-04-28T14:20:01.000Z"
  }
}

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.blindspotr.io/v1/token/MINT_ADDRESS/intelligence

const response = await fetch(
  'https://api.blindspotr.io/v1/token/MINT_ADDRESS/intelligence',
  {
    headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
  }
);

const data = await response.json();

if (data.success) {
  const {
    canonicalRugScore,
    canonicalPeakScore,
    deployerProfile,
    cabalPresence,
    trajectoryPrediction,
    postScanTrajectory
  } = data.data;

  // Rug risk assessment
  console.log(`Rug Risk: ${canonicalRugScore.level}`);
  console.log(canonicalRugScore.levelDescription);

  // Setup quality
  console.log(`Setup: ${canonicalPeakScore.label}`);
  console.log(`Pump rate: ${(canonicalPeakScore.pumpRate * 100).toFixed(0)}%`);
  console.log(`Avg peak when pumps: ${canonicalPeakScore.avgMultWhenPumps}x`);

  // Deployer profile
  console.log(`Deployer: ${deployerProfile.type} (${deployerProfile.totalTokens} tokens, ${deployerProfile.riskAssessment})`);

  // Cabal detection
  if (cabalPresence.detected) {
    console.log(`Cabals: ${cabalPresence.summary.uniqueCabals} groups, ${cabalPresence.summary.totalMembersFound} members`);
    console.log(`Dominant type: ${cabalPresence.summary.dominantArchetype}`);
  }

  // Trajectory prediction
  if (trajectoryPrediction) {
    const t = trajectoryPrediction.priceTrajectory;
    console.log(`1h median: ${t.multiplier1h.median.toFixed(2)}x`);
    console.log(`Crash risk: ${t.pctCrashedBelow0_5x.toFixed(1)}%`);
  }

  // Post-scan confirmation
  if (postScanTrajectory?.status) {
    console.log(`Post-scan: ${postScanTrajectory.status}`);
    if (postScanTrajectory.historicalContext) {
      console.log(`Historical crash rate: ${(postScanTrajectory.historicalContext.crashRate * 100).toFixed(1)}%`);
    }
  }
}

import requests

headers = {"Authorization": "Bearer YOUR_API_KEY"}
mint = "MINT_ADDRESS"

response = requests.get(
    f"https://api.blindspotr.io/v1/token/{mint}/intelligence",
    headers=headers
)

data = response.json()

if data["success"]:
    payload = data["data"]

    # Rug risk assessment
    crs = payload["canonicalRugScore"]
    print(f"Rug Risk: {crs['level']}")
    print(crs["levelDescription"])

    # Setup quality
    cps = payload["canonicalPeakScore"]
    print(f"Setup: {cps['label']}")
    print(f"Pump rate: {cps['pumpRate']:.0%}")
    print(f"Avg peak when pumps: {cps['avgMultWhenPumps']}x")

    # Deployer profile
    deployer = payload["deployerProfile"]
    print(f"Deployer: {deployer['type']} ({deployer['totalTokens']} tokens, {deployer['riskAssessment']})")

    # Cabal detection
    cabal = payload["cabalPresence"]
    if cabal["detected"]:
        s = cabal["summary"]
        print(f"Cabals: {s['uniqueCabals']} groups, {s['totalMembersFound']} members")
        print(f"Dominant type: {s['dominantArchetype']}")

    # Trajectory prediction
    traj = payload.get("trajectoryPrediction")
    if traj:
        t = traj["priceTrajectory"]
        print(f"1h median: {t['multiplier1h']['median']:.2f}x")
        print(f"Crash risk: {t['pctCrashedBelow0_5x']:.1f}%")

    # Post-scan confirmation
    pst = payload.get("postScanTrajectory")
    if pst and pst.get("status"):
        print(f"Post-scan: {pst['status']}")
        ctx = pst.get("historicalContext")
        if ctx:
            print(f"Historical crash rate: {ctx['crashRate']:.1%}")