Wallet Analysis Endpoint

Comprehensive guide to the wallet analysis API endpoint and parameters

Wallet Analysis API

Comprehensive Analysis

Deep dive into wallet transaction history and patterns

Real-time Results

Get analysis results in under 3 minutes

Risk Detection

Identify potential AML and compliance risks

Detailed Scoring

Numerical risk scores with explanations

Supported Networks

The wallet analysis endpoint supports over 8000+ cryptocurrencies across major networks including Bitcoin, Ethereum, BNB Chain, Solana, Cardano, Avalanche, Polygon, and many more.

Analysis Endpoints

POST/analyze

10 requests/minute

Analyze a wallet address for AML risks

GET/analysis/{id}

100 requests/minute

Retrieve analysis results by ID

GET/networks

50 requests/minute

List all supported blockchain networks

Request Parameters

Parameter	Type	Required	Description	Example
wallet_address	string	Required	The wallet address to analyze	0x742d35Cc6634C0532925a3b8D4C9db4C9db4C9db
network	string	Required	The blockchain network	ethereum
depth	integer	Optional	Analysis depth (1-5, default: 3)	3
include_details	boolean	Optional	Include detailed risk factors	true

Response Format

Success Response (200 OK)

{
  "analysis_id": "ana_1234567890",
  "wallet_address": "0x742d35Cc6634C0532925a3b8D4C9db4C9db4C9db",
  "network": "ethereum",
  "risk_score": 15,
  "risk_level": "low",
  "timestamp": "2025-01-15T10:30:00Z",
  "details": {
    "total_transactions": 1247,
    "total_volume": "125.67",
    "first_transaction": "2023-01-15T08:20:00Z",
    "last_transaction": "2025-01-15T09:45:00Z",
    "risk_factors": [],
    "recommendations": [
      "continue_monitoring",
      "verify_large_transactions"
    ],
    "compliance_status": "clean"
  },
  "metadata": {
    "analysis_duration": 2.3,
    "data_sources": ["blockchain", "exchange_data"],
    "confidence_score": 0.95
  }
}

Error Response (400 Bad Request)

{
  "error": {
    "code": "INVALID_ADDRESS",
    "message": "The provided wallet address is not valid",
    "details": {
      "field": "wallet_address",
      "provided": "invalid_address"
    }
  },
  "timestamp": "2025-01-15T10:30:00Z",
  "request_id": "req_1234567890"
}