Classify an EVM wallet into a behavioral archetype with confidence API

Behavioral archetype classifier for an EVM wallet. Pulls Blockscout lifetime counters plus the most-recent transactions and ERC-20 token-transfers, derives a panel of activity metrics (lifetime tx count, wallet age, active days, token diversity, inbound/outbound transfer ratio, distinct inbound senders, contract-creation count, avg tx/day, dormancy) and collapses them into a single archetype — active_trader, hodler, bot_high_frequency, airdrop_farmer, contract_deployer, fresh_wallet, or dormant — with a 0-1 confidence, a runner-up alternate, the behavioral signals that drove the call, and the full metric panel. Answers 'What kind of wallet is this?', 'Is this address a bot or a real user?', 'Is this wallet an airdrop farmer / sybil?', 'Is this a long-term hodler or an active trader?', 'Is this wallet fresh or dormant?'.

Price$0.16per request

MethodPOST

Route/v1/chain/wallet-behavior-profile

StatusLive

MIME typeapplication/json

Rate limit60/minute

Cache900s public

chainwalletarchetypebehaviorclassificationsybilbot-detectionactivityprofiling

API URLhttps://x402.hexl.dev/v1/chain/wallet-behavior-profile

Integration docs

Example request

{
  "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
  "chain": "ethereum"
}

Example response

{
  "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
  "chain": "ethereum",
  "archetype": "bot_high_frequency",
  "confidence": 0.9,
  "alternate": {
    "archetype": "airdrop_farmer",
    "confidence": 0.85
  },
  "signals": [
    "3725.9 tx/active-day at 78244 lifetime tx (automation-like)",
    "13 distinct inbound senders, inbound ratio 0.96 (dusting/airdrop pattern)",
    "78244 tx / 402324 transfers — sustained trading volume"
  ],
  "metrics": {
    "txCount": 78244,
    "tokenTransferCount": 402324,
    "walletAgeDays": 23.9,
    "dormancyDays": 0,
    "activeDays": 21,
    "avgTxPerDay": 3271.1,
    "txPerActiveDay": 3725.9,
    "tokenDiversity": 41,
    "inboundTransfers": 48,
    "outboundTransfers": 2,
    "inboundRatio": 0.96,
    "distinctInboundSenders": 13,
    "contractCreations": 0
  },
  "scores": [
    {
      "archetype": "bot_high_frequency",
      "score": 0.9
    },
    {
      "archetype": "airdrop_farmer",
      "score": 0.85
    },
    {
      "archetype": "active_trader",
      "score": 0.35
    },
    {
      "archetype": "hodler",
      "score": 0
    },
    {
      "archetype": "fresh_wallet",
      "score": 0
    },
    {
      "archetype": "dormant",
      "score": 0
    },
    {
      "archetype": "contract_deployer",
      "score": 0
    }
  ],
  "firstSeen": "2026-05-11T09:14:35.000Z",
  "lastSeen": "2026-06-04T14:03:59.000Z",
  "sampleSize": {
    "transactions": 50,
    "tokenTransfers": 50
  },
  "disclaimer": "Best-effort behavioral classification from Blockscout lifetime counters plus a bounded sample of the most-recent transactions and ERC-20 transfers. Archetype + confidence are heuristic and not a guarantee of identity or intent; wallets with native-only activity may be under-sampled. Verify before relying on it."
}

Input schema

{
  "type": "object",
  "required": [
    "address"
  ],
  "properties": {
    "address": {
      "type": "string",
      "description": "0x-prefixed 40-hex EVM address to classify."
    },
    "chain": {
      "type": "string",
      "enum": [
        "ethereum",
        "base"
      ],
      "default": "ethereum",
      "description": "Chain to read activity from."
    }
  },
  "examples": [
    {
      "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
      "chain": "ethereum"
    }
  ]
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}