Documentation

Complete guide to using the ChainIntel AI blockchain intelligence platform.

Overview

ChainIntel AI is an AI-powered blockchain intelligence platform that analyzes token risks, developer behavior, and on-chain patterns in real-time. Our system combines smart contract analysis, wallet graph exploration, and machine learning to deliver transparent, explainable risk scores.

Quick Start

Get started with ChainIntel AI in three steps:

1. Enter a token address — Paste any token contract address into the search bar on the dashboard.
2. Select the chain — Choose the blockchain network (Ethereum, Solana, BSC, etc.).
3. Review the report — Our AI analyzes the token and returns a risk score with detailed explanation.

Using the API

For programmatic access, use our REST API:

curl -X POST https://api.chainintel.ai/v1/analyze \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f4f2a",
    "chain": "ethereum"
  }'

Supported Chains

ChainIntel AI currently supports analysis across the following blockchain networks:

• Ethereum — Full ERC-20 token analysis, smart contract decompilation
• Solana — SPL token analysis, program account inspection
• BSC (BNB Chain) — BEP-20 tokens, PancakeSwap liquidity tracking
• Arbitrum — L2 token analysis with L1 bridge monitoring
• Base — Full support including Uniswap V3 pools
• Polygon — PoS chain token and liquidity analysis
• Avalanche — C-Chain ERC-20 token support
• Optimism — L2 analysis with cross-chain tracking

Risk Score

The ChainIntel AI Risk Score is a value from 0 to 100 that represents the overall risk level of a token. Higher scores indicate higher risk.

The risk score is calculated by our AI model based on weighted analysis of multiple factors including contract permissions, holder distribution, liquidity status, developer history, and on-chain behavior patterns.

Confidence Score

Each analysis includes a confidence score (0-100%) that indicates how certain our AI is about the risk assessment. Factors that can lower confidence include limited on-chain data, unverified source code, or new tokens with short history.

Risk Factors

Our AI evaluates the following categories of risk:

Contract Risks

• Mint privileges — Owner can mint unlimited tokens
• Blacklist functions — Addresses can be blocked from trading
• Proxy contracts — Code can be changed after deployment
• Hidden fees — Excessive or hidden transfer taxes
• Honeypot patterns — Buy enabled, sell disabled or restricted

Liquidity Risks

• Unlocked liquidity — LP tokens not locked, vulnerable to drain
• Low liquidity — Insufficient depth for safe trading
• Single-sided liquidity — Concentrated in one provider

Holder Risks

• Concentrated supply — Small number of wallets hold majority of tokens
• Sybil clusters — Multiple wallets controlled by same entity
• Bundler activity — Coordinated buying in the same block

Developer Risks

• Previous rugs — Developer previously deployed failed/scam tokens
• Anonymous deployer — No verifiable identity or history
• Funding trail — Deployer funded by known scam wallets

Wallet Graph

The Wallet Graph Explorer visualizes connections between wallets associated with a token. It helps identify:

• Funding chains — Where deployer funds originate
• Wallet clusters — Groups of wallets controlled by the same entity
• Exit paths — How funds flow after a potential rug pull
• CEX connections — Links to known exchange wallets

Developer Reputation

Our Developer Reputation Engine tracks deployer wallets across all supported chains. Each developer profile includes:

• Total number of deployed tokens
• Success/failure ratio of previous projects
• Average token lifespan
• Known wallet aliases and funding sources
• Cross-chain activity history

Authentication

All API requests require a valid API key passed in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Get your API key from the dashboard settings. Free tier includes 10 requests/day. Pro and Enterprise tiers have higher limits.

Analyze Token POST

Submit a token for analysis. Returns a risk report with score and detected factors.

POST https://api.chainintel.ai/v1/analyze

Request Body

Response

{
  "status": "completed",
  "token": {
    "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f4f2a",
    "name": "ShadowToken",
    "symbol": "SHDW",
    "chain": "ethereum"
  },
  "risk": {
    "score": 78,
    "level": "high",
    "confidence": 0.91,
    "factors": [
      {
        "category": "contract",
        "severity": "critical",
        "description": "Owner retains mint privileges"
      },
      {
        "category": "holders",
        "severity": "high",
        "description": "82% supply held by 3 wallets"
      }
    ]
  },
  "report_url": "https://chainintel.ai/report/0x742d"
}

Get Report GET

Retrieve a previously generated analysis report.

GET https://api.chainintel.ai/v1/report/{report_id}

Parameters

Wallet Lookup GET

Look up wallet reputation and associated tokens.

GET https://api.chainintel.ai/v1/wallet/{address}?chain=ethereum

Response includes:

• Wallet reputation score
• Associated deployed tokens
• Transaction patterns
• Known labels and tags
• Connected wallet clusters

Webhooks & Alerts

Set up real-time alerts for token events. Available on Pro and Enterprise plans.

Supported Events

• risk_change — Risk score changed significantly
• liquidity_removed — Liquidity withdrawn from pool
• ownership_transferred — Contract ownership changed
• large_transfer — Whale movement detected
• new_token_by_dev — Tracked developer deployed new token

Webhook Configuration

POST https://api.chainintel.ai/v1/webhooks
{
  "url": "https://your-server.com/webhook",
  "events": ["risk_change", "liquidity_removed"],
  "filters": {
    "chains": ["ethereum", "solana"],
    "min_risk_score": 50
  }
}

Telegram Bot

Use our Telegram bot for instant token analysis from any chat:

1. Find @ChainIntelAIBot on Telegram
2. Send a token address to get an instant risk analysis
3. Use /watch 0x... to set up alerts for a token
4. Use /wallet 0x... to check wallet reputation

Discord Bot

Add ChainIntel AI to your Discord server:

1. Invite the bot from the dashboard
2. Use /scan <address> <chain> in any channel
3. Configure alert channels with /alerts setup #channel
4. Manage watchlists with /watch add|remove <address>