Sign in

v1

latestSwagger 2.02026-08-0651043.0 KB
Behaviour Prediction API

Get wallet behaviour segment and quality score

Classifies a wallet address into a quality segment (A, B, or C) based on its on-chain behaviour history, and returns a 0–100 quality score for finer-grained ranking.

Use this endpoint to distinguish high-value users from low-value or low-intent users at the moment they connect to your protocol — without requiring any off-chain identity data.

Subscription: Enterprise.

Supported networks: ETH, BNB, BASE, HAQQ, SOLANA .

Further reading: Web3 Behavioral User Analytics Guide

post/segmentation/wallet-segment

Request body

walletAddressstring required

The wallet address to classify.

network'ETH' | 'BNB' | 'BASE' | 'HAQQ' | 'SOLANA' required

Blockchain network to query.

Example request

{
  "walletAddress": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
  "network": "ETH"
}

Response

Wallet segment and quality score

messagestring

Result status message.

walletAddressstring

Blockchain wallet address analyzed.

walletQualityinteger

Calculated wallet quality score from 0 to 100 derived from segment, protocol diversity, balance history, and wallet behavior.

segmentInfostring

Serialized JSON containing protocol engagement flags used for segment classification.

Example response

{
  "message": "Wallet segment retrieved",
  "walletAddress": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
  "walletQuality": 87,
  "categories": [
    {
      "Category": "DeFi",
      "Count": 142
    }
  ],
  "riskProfile": [
    {
      "Category": "Risk_Profile",
      "Balance_age": 4
    }
  ],
  "segmentInfo": "{\"Maker\":0,\"Aave_borrow\":0,\"Aave_lend\":1,\"Lido\":0,\"Uniswap\":1}",
  "experience": {
    "Type": "Experience",
    "Value": 10
  },
  "intention": {
    "Type": "Intentions",
    "Value": {
      "Prob_Lend": "High",
      "Prob_Trade": "High",
      "Prob_Game": "Medium",
      "Prob_NFT": "Low",
      "Prob_Stake_ETH": "Medium",
      "Prob_Borrow": "Low",
      "Prob_Gamble": "Low",
      "Prob_Stake": "Medium",
      "Prob_Yield_Farm": "Low",
      "Prob_Leveraged_Stake": "Low",
      "Prob_Leveraged_Stake_ETH": "Low",
      "Prob_Leveraged_Lend": "Low",
      "Prob_Leverage_Long_ETH": "Low",
      "Prob_Leverage_Long": "Low"
    }
  },
  "protocols": [
    {
      "Protocol": "uniswap",
      "Count": 34
    }
  ],
  "userDetails": {
    "wallet_age_days": 3798,
    "total_balance_usd": 104859.49,
    "transaction_count": 19972,
    "wallet_rank": 20042
  },
  "recommendation": {
    "Type": "Recommendation",
    "Value": [
      "WBTC holding",
      "ETH holding",
      "Stablecoin lending"
    ]
  },
  "sanctionData": [
    {
      "createdAt": "2026-03-12T16:01:18.000Z",
      "updatedAt": "2026-03-12T16:01:18.000Z"
    }
  ]
}