x402 Crypto API

Get comprehensive token metadata with security analysis. Returns price, liquidity, holder data, and safety checks (honeypot detection, tax analysis, risk scoring).

// Example Response
{
  "success": true,
  "data": {
    "name": "Wrapped Ether",
    "symbol": "WETH",
    "price_usd": 3112.18,
    "liquidity_usd": 10003095,
    "holder_count": 4761652,
    "safety": {
      "is_honeypot": false,
      "buy_tax": 0,
      "sell_tax": 0,
      "is_mintable": false
    },
    "risk_score": 0,
    "risk_level": "minimal"
  }
}

Get website/domain trust score. Analyzes WHOIS data, SSL certificates, domain patterns, and returns a trust score (0-100) with recommendations.

// Example Response
{
  "success": true,
  "data": {
    "domain": "google.com",
    "trust_score": 95,
    "risk_level": "low",
    "whois": {
      "registrar": "MarkMonitor Inc.",
      "created_date": "1997-09-15",
      "expires_date": "2028-09-14"
    },
    "ssl": {
      "valid": true,
      "issuer": "Google Trust Services",
      "days_until_expiry": 60
    },
    "recommendations": [
      {"level": "positive", "message": "No significant trust issues detected."}
    ]
  }
}

Decode and analyze a smart contract using AI. Returns a plain English explanation of what the contract does, key functions, risk assessment, and security concerns.

// Example Response
{
  "success": true,
  "data": {
    "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "chain": "base",
    "contract_name": "FiatTokenV2_2",
    "verified": true,
    "analysis": {
      "summary": "This is Circle's USDC stablecoin contract on Base...",
      "purpose": "ERC20 Stablecoin",
      "key_functions": [
        {"name": "transfer", "description": "Transfer USDC to another address"},
        {"name": "approve", "description": "Approve spending allowance"}
      ],
      "risk_level": "low",
      "security_notes": ["Centralized control by Circle", "Has blacklist functionality"]
    }
  }
}

Get wallet identity and enrichment data including ENS names, known labels (exchanges, bridges, DeFi), transaction activity, token holdings, and risk assessment.

// Example Response
{
  "success": true,
  "data": {
    "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
    "chain": "ethereum",
    "identity": {
      "ens_name": "vitalik.eth",
      "known_label": "vitalik.eth",
      "wallet_type": "notable",
      "is_contract": false
    },
    "balance": {
      "native": 1234.56,
      "native_symbol": "ETH"
    },
    "activity": {
      "total_transactions": 1500,
      "first_seen": "2015-08-07T...",
      "last_seen": "2024-01-10T...",
      "wallet_age_days": 3078
    },
    "risk": {
      "score": 0,
      "level": "minimal",
      "factors": []
    }
  }
}

Get wallet identity across ALL supported chains (Ethereum, Base, Arbitrum, Polygon, Optimism). Aggregates balances, transactions, and activity into a comprehensive cross-chain profile.

// Example Response
{
  "success": true,
  "data": {
    "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
    "cross_chain_summary": {
      "total_value_usd": 75000.00,
      "total_transactions": 2500,
      "chains_active": 4,
      "wallet_age_days": 3758
    },
    "chains": {
      "ethereum": {"balance": {"native": 23.68, "native_usd": 73500}},
      "base": {"balance": {"native": 0.5, "native_usd": 1550}},
      "arbitrum": {"balance": {"native": 0.0, "native_usd": 0}},
      ...
    },
    "ai_analysis": {
      "wallet_profile": "whale",
      "behavior_summary": "..."
    }
  }
}

Get real-time gas prices with EIP-1559 data, USD cost estimates, network congestion status, and timing recommendations.

// Example Response
{
  "success": true,
  "data": {
    "chain": "ethereum",
    "gas_prices": {
      "low": {"gwei": 15, "transfer_cost_usd": 0.98},
      "medium": {"gwei": 20, "transfer_cost_usd": 1.31},
      "high": {"gwei": 25, "transfer_cost_usd": 1.64},
      "instant": {"gwei": 30, "transfer_cost_usd": 1.97}
    },
    "eip1559": {
      "base_fee_gwei": 12.5,
      "priority_fee_medium": 7.5
    },
    "network_status": {"level": "normal", "description": "Normal network activity"},
    "recommendation": {"action": "proceed", "reason": "Gas prices are reasonable"}
  }
}

Get comprehensive token price data including current price, 24h/7d/30d changes, market cap, volume, ATH/ATL, and optional 7-day price history.

// Example Response
{
  "success": true,
  "data": {
    "token": {"id": "ethereum", "symbol": "ETH", "name": "Ethereum"},
    "price": {"usd": 3100.50, "usd_formatted": "$3,100.50"},
    "changes": {
      "24h": {"percent": 2.5, "direction": "up"},
      "7d": {"percent": -1.2, "direction": "down"},
      "30d": {"percent": 15.3, "direction": "up"}
    },
    "market": {
      "market_cap": 373000000000,
      "market_cap_rank": 2,
      "volume_24h": 15000000000
    },
    "ath": {"price": 4878.26, "date": "2021-11-10"},
    "atl": {"price": 0.432979, "date": "2015-10-20"}
  }
}

Get NFT metadata including collection info, token attributes, current owner, and transfer history.

// Example Response
{
  "success": true,
  "data": {
    "collection": {"name": "Bored Ape Yacht Club", "verified": true},
    "metadata": {"name": "BAYC #1234", "image": "ipfs://..."},
    "ownership": {"current_owner": "0x...", "transfer_count": 5}
  }
}

Get token holder distribution, whale concentration, and centralization risk metrics.

// Example Response
{
  "success": true,
  "data": {
    "holder_count": 1500000,
    "concentration": {"top_10_percent": 45.2, "risk_level": "medium"},
    "top_holders": [{"rank": 1, "address": "0x...", "percentage": 5.2}]
  }
}

Check token approvals across all EVM chains (Ethereum, Base, Arbitrum, Polygon, Optimism) with risk assessment and revoke recommendations.

// Example Response (chain: "all")
{
  "success": true,
  "data": {
    "chain": "all",
    "chains_scanned": ["ethereum", "base", "arbitrum", "polygon", "optimism"],
    "chains_with_approvals": ["ethereum", "base"],
    "cross_chain_summary": {"total_approvals": 15, "unlimited_approvals": 3, "overall_risk": "medium"},
    "per_chain": {"ethereum": {"summary": {...}}, "base": {"summary": {...}}, ...},
    "all_erc20_approvals": [{"chain": "base", "token": "USDC", "spender_label": "Uniswap V3", "is_unlimited": true}],
    "recommendations": [{"priority": "high", "action": "revoke_unknown"}]
  }
}

Decode a transaction with AI-powered plain English explanation of what happened.

// Example Response
{
  "success": true,
  "data": {
    "transaction": {"type": "swap", "status": "success", "value": {"native": 0.5}},
    "ai_analysis": {
      "summary": "Swapped 0.5 ETH for 1,500 USDC on Uniswap V3",
      "action_type": "swap",
      "involved_assets": ["ETH", "USDC"]
    }
  }
}

Analyze wallet's DeFi positions across Uniswap, Aave, staking protocols, and more.

// Example Response
{
  "success": true,
  "data": {
    "summary": {"total_positions": 5, "liquidity_pools": 2, "lending_positions": 1},
    "positions": {"liquidity_pools": [...], "lending": [...], "staking": [...]},
    "ai_analysis": {"defi_profile": "moderate", "risk_assessment": "low"}
  }
}

Check ENS domain expiration dates for wallet addresses. Returns expiry status, grace period, renewal costs.

// Example Response
{
  "success": true,
  "data": {
    "results": [
      {
        "address": "0xd8dA...",
        "ens_name": "vitalik.eth",
        "expiry_date": "2032-05-04T00:00:00+00:00",
        "days_until_expiry": 2275,
        "status": "active",
        "grace_period_end": "2032-08-02T00:00:00+00:00",
        "renewal_cost_yearly_usd": 5.00
      }
    ],
    "addresses_without_ens": []
  }
}