Detective Chain Documentation

Detective Chain is a Blockchain Behavior Search Engine built on Solana. Instead of just showing balances and transactions, we analyze behavioral patterns — detecting bots, insiders, coordinated traders, and predicting outcomes based on historical matches.

Platform Features

🔍 Behavior Scanner

Paste any Solana wallet address. Get instant behavioral analysis.

What It Does

The Behavior Scanner analyzes the last 100 transactions of any wallet and produces a comprehensive behavioral report including:

• Entity Type Classification — Retail, Bot/MEV, Whale, Coordinated Trader, Distribution Wallet, Insider, NFT Trader
• Risk Score (0-100) — Higher = more suspicious behavior patterns
• Bot Probability — Percentage chance the wallet is automated (based on transaction timing)
• Trading Style Breakdown — What % of activity is swaps, transfers, NFTs, etc.
• Historical Pattern Matches — Similar wallets from our database and their outcomes
• Activity Timeline — Recent transactions with parsed descriptions

How Entity Detection Works

When To Use It

• Before trading a token — check if the deployer's wallet looks suspicious
• Investigating a rug pull — analyze involved wallets
• Due diligence on a project team
• Checking if a wallet that contacted you is a bot or real person

🕵️ Crime Scene Reconstruction

Input a token address. AI reconstructs the complete event timeline.

What It Does

Like a forensic investigator for blockchain — this tool reconstructs what happened to a token from creation to current state:

• Event Timeline — Token creation, liquidity added, trading start, price movements, suspicious events
• Verdict — Organic Growth, Coordinated Pump & Dump, Rug Pull, Wash Trading, etc.
• Entity Mapping — Top holders and their roles (deployer, LP provider, whale, etc.)
• Impact Assessment — Price change, duration, number of entities involved

Supported Input Types

Verdict Types

When To Use It

• Investigating a token that crashed — understand what happened
• Before buying a new token — check for red flags
• Research and journalism — reconstruct on-chain events
• Compliance — document what happened for legal/regulatory purposes

🧬 Wallet DNA

Every wallet has a unique behavioral fingerprint.

What It Does

Wallet DNA creates a comprehensive "fingerprint" of any wallet's behavior — like a credit report, but for on-chain activity:

• Trading Style Profile — Momentum, Arbitrage, Long-term Hold, Meme/Degen, Sniping, DCA
• Behavior Traits — Bot %, Whale %, Insider %, Speed, Precision, Frequency
• Reputation Score (0-900) — Like a credit score for blockchain wallets
• Similar DNA Profiles — Find wallets that behave the same way

Reputation Score Breakdown

Behavior Traits Explained

When To Use It

• Understanding your own wallet's on-chain reputation
• Vetting a counterparty before an OTC deal
• Finding wallets with similar strategies to follow
• Building trust scores for lending/DAO participation

🌤️ Network Weather

Real-time activity forecast for the Solana network.

What It Does

Think of it as a weather forecast, but for blockchain activity. Before you trade or deploy, check the "weather" first:

• Activity Score (0-100) — How busy is the network right now?
• Status — Normal (🟢), Elevated (🟠), or Extreme (🔴)
• Volatility Probability — Chance of major price movements in next 30 minutes
• Signals — TPS, DEX activity, slot time, token launches

Status Levels

Signal Meanings

When To Use It

• Before executing a large swap — check if conditions are calm
• Before launching a token — avoid extreme activity periods
• Monitoring for trading opportunities — extreme = volatility = opportunity
• Bot developers — adjust parameters based on network conditions

📡 Live Detections

Real-time AI-powered behavioral alerts on trending tokens.

What It Does

Live Detections monitors trending tokens from DexScreener in real-time and runs AI risk analysis on each one:

• Automatic Scanning — Fetches top 20 boosted tokens every 30 seconds
• AI Risk Scoring — Each token analyzed for red flags and positive signals
• Classification — HIGH / MEDIUM / LOW risk badges
• Filtering — Filter by risk level or chain (Solana only)
• Detail Modal — Click any card for full AI analysis and risk factors

Risk Factors Analyzed

When To Use It

• Monitoring the market for emerging risks in real-time
• Quick screening of trending tokens before investing
• Finding projects that pass basic due diligence

🔌 API Reference

All endpoints return JSON. Base URL: https://your-domain.com

Available Endpoints

GET /api/wallet/:address

Analyze any Solana wallet's behavioral patterns.

Parameters

Example Request

Response

{
  "success": true,
  "data": {
    "address": "vines1vzrYbzLMRdu58ou5XTby4qAqVRLmqo36NKPTg",
    "entityType": "Distribution Wallet",
    "riskScore": 20,
    "botProbability": 0,
    "tradingStyle": {
      "Swap / DEX": 5,
      "Transfers": 63,
      "NFT Activity": 31,
      "Unique Tokens": 10,
      "Frequency": 40
    },
    "behaviorTraits": {
      "bot": 0,
      "whale": 0,
      "insider": 28,
      "speed": 0,
      "precision": 0,
      "frequency": 40
    },
    "creditScore": 550,
    "timeline": [
      {
        "time": "31/5/2026, 16:20:05",
        "action": "TRANSFER",
        "detail": "E16prL... transferred 0.0001 SOL (via SYSTEM_PROGRAM)"
      }
    ],
    "stats": {
      "totalTransactions": 20,
      "swaps": 1,
      "transfers": 12,
      "nftActivity": 6,
      "uniqueCounterparties": 14,
      "totalVolumeSol": 0.08,
      "tokensBought": 2,
      "tokensSold": 0,
      "solBalance": 0.039,
      "tokensHeld": 15
    },
    "matches": [
      { "pct": 66, "title": "Pattern: Distribution Wallet", "outcome": "neutral", "outcomeText": "Neutral" }
    ]
  }
}

Response Fields

GET /api/token/:address

Reconstruct the event timeline for any Solana token.

Parameters

Example Request

Response

{
  "success": true,
  "data": {
    "address": "ATzgiEn7j...",
    "tokenMeta": { "content": { "metadata": { "name": "Grokie Inu", "symbol": "GROKIE" } } },
    "dexData": [
      { "baseToken": { "name": "Grokie Inu", "symbol": "GROKIE" }, "priceUsd": "0.0001", "liquidity": { "usd": 12000 }, "volume": { "h24": 5000 } }
    ],
    "holders": [ { "address": "...", "amount": "500000000" } ],
    "timeline": {
      "events": [
        { "time": "Genesis", "action": "Token Created", "detail": "Grokie Inu (GROKIE) deployed", "type": "" },
        { "time": "2026-06-01 10:00", "action": "Liquidity Pair Created", "detail": "raydium · Initial liquidity: $12,000", "type": "success" }
      ],
      "verdict": "Organic Growth",
      "isRug": false,
      "duration": "1440h",
      "entities": 8,
      "impact": "+25.3%",
      "tokenInfo": { "name": "Grokie Inu", "symbol": "GROKIE", "price": "0.0001", "liquidity": 12000, "volume24h": 5000, "marketCap": 100000 }
    }
  }
}

GET /api/network/weather

Get real-time Solana network activity forecast. Cached for 15 seconds.

Example Request

Response

{
  "success": true,
  "data": {
    "chain": "solana",
    "timestamp": "2026-08-11T06:13:12.633Z",
    "status": "extreme",
    "activityScore": 74,
    "volatilityProbability": 0.5,
    "tps": 2989,
    "slotTime": 423,
    "dexVolume24h": 500000000,
    "topPairsTracked": 7,
    "circulatingSupply": 582481721337970600,
    "signals": {
      "tpsLevel": "high",
      "dexActivity": "medium",
      "networkLoad": "high"
    }
  }
}

Response Fields

GET /api/trending

Get currently trending/boosted tokens from DexScreener. Cached for 30 seconds.

Example Request

Response

{
  "success": true,
  "data": [
    {
      "url": "https://dexscreener.com/solana/...",
      "chainId": "solana",
      "tokenAddress": "XSTuo1fV7HHMhs4BYiwtr...",
      "description": "AI infrastructure marketplace token",
      "icon": "4FBfJx3u81RdZxcf",
      "links": [
        { "url": "https://project-website.com" },
        { "type": "twitter", "url": "https://x.com/project" }
      ],
      "totalAmount": 500
    }
  ]
}

📋 Use Cases

📡 Data Sources

⚙️ Rate Limits & Caching