Metadata Engine C2 - Comprehensive Token Intelligence

Description

The Metadata Engine C2 provides comprehensive metadata collection and risk assessment for cryptocurrency tokens across multiple blockchains. It aggregates data from blockchain explorers, GitHub repositories, and project websites to deliver a complete intelligence profile with automated risk scoring.

Features

• Multi-Chain Support: Ethereum, BSC, Polygon, Solana blockchain data
• Comprehensive Data Sources: Explorer APIs, GitHub statistics, website analysis
• Risk Assessment: Automated 0-100 risk scoring based on multiple factors
• Social Media Detection: Automatic extraction of Twitter, Telegram, Discord links
• Webhook Integration: Real-time and batch delivery options
• Flexible Input: Optional contract addresses, websites, and GitHub repos

Input Schema

interface MetadataEngineInput {
    tokens: {
        symbol: string;
        chain: string;
        contract?: string;    // Optional contract address
        website?: string;     // Optional project website
        github?: string;      // Optional GitHub repository
    }[];
    webhook_url?: string;
    webhook_mode?: "instant" | "batch";
}

Output Schema

interface MetadataEngineOutput {
    total_tokens: number;
    results: MetadataResult[];
}

interface MetadataResult {
    symbol: string;
    chain: string;
    contract?: string;
    
    explorer?: {
        chain: string;
        contract: string;
        total_supply?: number;
        circulating_supply?: number;
        holders?: number;
        verified?: boolean;
    };
    
    github?: {
        repo_url: string;
        stars?: number;
        forks?: number;
        open_issues?: number;
        last_commit?: string;
        activity_score?: number;  // 0-1 normalized
    };
    
    website?: {
        website: string;
        title?: string;
        description?: string;
        twitter?: string;
        telegram?: string;
        discord?: string;
    };
    
    risk_score?: number;  // 0-100 risk assessment
}

Example Run

Input

{
    "tokens": [
        {
            "symbol": "USDC",
            "chain": "ethereum",
            "contract": "0xA0b86a33E6441e0e5d7e5c4f27Ead9083C756Cc2",
            "website": "https://centre.io",
            "github": "https://github.com/centrehq/centre-tokens"
        },
        {
            "symbol": "SOL",
            "chain": "solana",
            "website": "https://solana.com",
            "github": "https://github.com/solana-labs/solana"
        }
    ],
    "webhook_mode": "batch"
}

Output

{
    "total_tokens": 2,
    "results": [
        {
            "symbol": "USDC",
            "chain": "ethereum",
            "contract": "0xA0b86a33E6441e0e5d7e5c4f27Ead9083C756Cc2",
            "explorer": {
                "chain": "ethereum",
                "contract": "0xA0b86a33E6441e0e5d7e5c4f27Ead9083C756Cc2",
                "total_supply": 24000000000,
                "holders": 1250000,
                "verified": true
            },
            "github": {
                "repo_url": "https://github.com/centrehq/centre-tokens",
                "stars": 342,
                "forks": 89,
                "open_issues": 12,
                "last_commit": "2024-12-01T10:30:00Z",
                "activity_score": 0.65
            },
            "website": {
                "website": "https://centre.io",
                "title": "Centre - USDC Stablecoin",
                "description": "The world's leading digital dollar",
                "twitter": "https://twitter.com/centre_io",
                "telegram": null,
                "discord": "https://discord.gg/centre"
            },
            "risk_score": 15
        },
        {
            "symbol": "SOL",
            "chain": "solana",
            "explorer": null,
            "github": {
                "repo_url": "https://github.com/solana-labs/solana",
                "stars": 12500,
                "forks": 3200,
                "open_issues": 456,
                "last_commit": "2024-12-02T15:45:00Z",
                "activity_score": 0.95
            },
            "website": {
                "website": "https://solana.com",
                "title": "Solana - Fast, Secure, Scalable",
                "description": "Build crypto apps that scale",
                "twitter": "https://twitter.com/solana",
                "telegram": "https://t.me/solana",
                "discord": "https://discord.gg/solana"
            },
            "risk_score": 8
        }
    ]
}

Data Sources

1. Blockchain Explorers:

   • Etherscan (Ethereum)
   • BSCScan (Binance Smart Chain)
   • PolygonScan (Polygon)
   • SolScan (Solana)

2. GitHub API: Repository statistics and development activity

3. Website Analysis: Metadata extraction and social media link detection

Risk Scoring Algorithm

The risk score (0-100, lower is better) considers:

• Contract Verification: -20 points if verified
• Holder Count: -10 points if >1,000 holders
• GitHub Activity: -10 points if >100 stars, -5 if high activity
• Website Presence: -5 points if professional website
• Social Media: -2 points each for Twitter/Telegram presence

Configuration

Environment variables:

• ETHERSCAN_API_KEY: Etherscan API key
• BSCSCAN_API_KEY: BSCScan API key
• POLYGONSCAN_API_KEY: PolygonScan API key
• GITHUB_TOKEN: GitHub API token (optional, for higher rate limits)
• HTTP_TIMEOUT_SECS: HTTP request timeout (default: 15)
• MAX_PARALLEL_REQUESTS: Concurrent request limit (default: 5)

Pricing

• Free Tier: Up to 10 tokens per run
• Standard: $0.05 per token analyzed
• Premium: $0.02 per token (bulk pricing for >1,000 tokens/month)
• Enterprise: Custom pricing with SLA guarantees

Use Cases

• Due Diligence: Comprehensive token research and risk assessment
• Portfolio Management: Automated metadata collection for holdings
• Investment Analysis: Compare projects across multiple dimensions
• Compliance: Verify contract details and project legitimacy
• Market Research: Track development activity and community engagement