# Web3 Due Diligence API

> Real-time scam detection and risk analysis for cryptocurrency tokens across 5+ blockchains. 47,000+ tokens analyzed. Identify rug pulls, honeypots, and scams before you invest.

Automated analysis of cryptocurrency projects to detect scam indicators. Evaluates smart contracts, token distribution, holder concentration, liquidity status, and on-chain behavior patterns.

## Quick Reference

**Example Queries:**
- Ethereum: Check 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb
- Solana: Check EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
- BNB Chain: Check 0xe9e7CEA3DedcA5984780Bafc599bD69ADd087D56

**API Endpoints:**

*Core Analysis:*
- POST /api/check - Main token analysis with 24h caching ([docs](/docs/endpoints/check))
- GET /api/status - System health and API configuration check ([docs](/docs/endpoints/status))

*x402 Protocol Suite:*
- POST /api/v1/quick-check - Fast simplified risk check (top 5 flags) ([docs](/docs/endpoints/quick-check))
- POST /api/v1/standard-report - Comprehensive analysis with database caching ([docs](/docs/endpoints/standard-report))
- POST /api/v1/deep-dive - Deep forensic analysis with historical comparison ([docs](/docs/endpoints/deep-dive))
- POST /api/v1/batch - Batch analysis for multiple tokens ([docs](/docs/endpoints/batch))

*Database & Discovery:*
- GET /api/tokens - Browse all analyzed tokens (search, filter, paginate) ([docs](/docs/endpoints/tokens))
- GET /api/tokens/{blockchain}/{address} - Full token details from database ([docs](/docs/endpoints/token-detail))
- GET /api/stats - Platform statistics and risk distribution ([docs](/docs/endpoints/stats))

*Tools:*
- GET /accuracy - Real-time accuracy dashboard
- GET /calculator - Interactive risk calculator
- GET /validator - Contract address validator

## Quick Start

- [Agent Documentation](/docs/AGENTS.md): Complete guide for AI agents and LLMs
- [API Reference](/docs/api-reference): Detailed endpoint specifications with examples
- [Getting Started Guide](/docs/quickstart): First request in 5 minutes

## Token Database

**Search & Explore:** Browse our database of 47,000+ analyzed tokens across all supported blockchains.

- [Search Tokens](/tokens.html): Find tokens by name, symbol, or contract address
- [View Statistics](/stats.html): Platform-wide analytics and risk distribution
- Example Token Pages:
  - [Ethereum Token](https://csds.blockchainrangers.com/tokens/ethereum/0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb)
  - [Solana Token](https://csds.blockchainrangers.com/tokens/solana/EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v)

**For AI Agents:**
- [Complete Token Database (Markdown)](/llms-tokens.txt): Machine-readable list of all evaluated tokens and protocols with risk scores
- Each token has a unique, SEO-optimized URL at `/tokens/{blockchain}/{address}` with comprehensive risk analysis, holder distribution, and liquidity data
- Markdown versions available at `/tokens/{slug}.md` for LLM consumption

## Common Use Cases

- [Verify Token Before Purchase](/docs/use-cases#verify-before-buy): Check if token is safe to buy
- [DeFi Protocol Integration](/docs/use-cases#defi-integration): Screen tokens in real-time
- [Portfolio Risk Analysis](/docs/use-cases#portfolio-scan): Analyze entire wallet holdings
- [Research & Due Diligence](/docs/use-cases#research): Deep forensic analysis

## Supported Blockchains

- [Ethereum](/docs/chains/ethereum): EVM-based token analysis
- [Solana](/docs/chains/solana): SPL token analysis
- [BNB Chain](/docs/chains/bsc): BSC token analysis
- [TON](/docs/chains/ton): TON blockchain support
- [All Chains](/docs/chains): Complete list and examples

## Data & Methodology

- [Risk Scoring System](/docs/methodology/scoring): How we calculate risk scores (0-100)
- [Data Sources](/docs/methodology/data-sources): Blockchain APIs, on-chain data, contract verification
- [Accuracy Dashboard](/accuracy): Real-time accuracy metrics (91%+ accuracy)
- [Database Statistics](/api/status): 47,000+ tokens analyzed and indexed

## Code Examples

- [Python Integration](/docs/examples/python): Complete Python SDK with async support
- [JavaScript Integration](/docs/examples/javascript): Node.js, Browser, and React examples
- [cURL Examples](/docs/examples/curl): Command-line usage and batch scripts
- [Error Handling](/docs/examples/errors): Best practices for handling errors

## Tools & Features

- [Token Database](/tokens.html): Browse 47,000+ analyzed tokens
- [Platform Statistics](/stats.html): Real-time analytics dashboard
- [Risk Calculator](/calculator): Interactive risk estimator
- [Address Validator](/validator): Validate contract addresses
- [API Status](/api/status): Real-time service status
- [Documentation](/docs): Complete API documentation

## Research & Resources

- [Scam Patterns](/docs/patterns): Common scam indicators and detection methods
- [Case Studies](/docs/research/case-studies): Real-world examples of detected scams
- [FAQ](/docs/faq): Frequently asked questions
- [Pricing](/docs/pricing): Cost breakdown and payment options

## For AI Agents & LLMs

This API is optimized for AI agent integration. See [AGENTS.md](/docs/AGENTS.md) for:
- Decision trees for when to use each endpoint
- Complete request/response examples
- Error handling patterns
- Rate limiting guidelines
- Integration code samples