Behaviour Prediction API¶

POST /fraud/audit¶

Profiles a wallet's complete on-chain history and predicts what it is likely to do next. Returns wallet categorisation, experience level, intent probabilities, personalisation recommendations, protocol history, and risk profiling.

Use this endpoint to personalise a user's onboarding journey, route wallets to the right product flow, or conduct targeted segmentation.

Base URL: https://enterprise.api.chainaware.ai

Authentication: x-api-key header required.

Subscription: Business or Enterprise.

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

Request¶

Headers¶

Body¶

Example request¶

curl -X POST https://enterprise.api.chainaware.ai/fraud/audit \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "network": "ETH",
    "walletAddress": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
  }'

Response¶

Top-level fields¶

userDetails - Core wallet metrics¶

experience - Expertise score¶

Integer 0-100 representing on-chain maturity derived from protocol diversity and activity longevity.

"experience": { "Type": "Experience", "Value": 87 }

intention - 14 predicted next-action signals¶

Probability of the wallet's next on-chain action in the near term. Each value is "High", "Medium", or "Low".

"intention": {
  "Type": "Intentions",
  "Value": {
    "Prob_Lend": "High",
    "Prob_Trade": "High",
    "Prob_Game": "Medium",
    "Prob_NFT": "Medium",
    "Prob_Stake_ETH": "Medium",
    "Prob_Stake": "Low",
    "Prob_Borrow": "Low",
    "Prob_Gamble": "Low",
    "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"
  }
}

categories - Behavioural activity segments¶

Array of activity domains and interaction counts:

"categories": [
  { "Category": "DeFi", "Count": 126 },
  { "Category": "Bridge User", "Count": 38 }
]

riskProfile - Risk exposure weighting¶

Balance-age weighted exposure by risk category:

"riskProfile": [
  { "Category": "Risk_Profile", "Balance_age": 3 }
]

protocols - Protocol usage history¶

Ordered list of protocols the wallet has interacted with, by frequency:

"protocols": [
  { "Protocol": "uniswap", "Count": 25 },
  { "Protocol": "aave", "Count": 14 }
]

recommendation - Personalisation suggestions¶

Array of product fit or engagement recommendations ready to use directly in agent context or UI:

"recommendation": {
  "Type": "Recommendation",
  "Value": [
    "WBTC holding",
    "ETH holding",
    "Stablecoin lending"
  ]
}

segmentInfo - Protocol engagement flags¶

Serialised JSON string of per-protocol engagement flags used internally for segment classification:

"segmentInfo": "{\"Maker\":0,\"Aave_borrow\":0,\"Aave_lend\":1,\"Lido\":0,\"Uniswap\":1}"

forensic_details - Fraud indicators¶

Binary flags (0/1) for each forensic dimension contributing to the fraud probability score:

sanctionData - Sanctions intelligence¶

Array of sanctions records associated with the wallet. isSanctioned: false with null category/name/description indicates no sanctions match.

"sanctionData": [
  {
    "category": null,
    "name": null,
    "description": null,
    "url": null,
    "isSanctioned": false,
    "createdAt": "2026-03-12T16:01:18.000Z",
    "updatedAt": "2026-03-12T16:01:18.000Z"
  }
]

Error codes¶

Common use cases¶

• Personalised onboarding - route Expert wallets directly to advanced features; guide Beginners through simplified flows
• Intent-matched CTAs - surface staking products to Prob_Stake High wallets; show trading features to Prob_Trade High wallets
• Airdrop quality filtering - exclude low-experience or suspicious wallets from reward programmes
• DeFi lending - assess borrower experience and risk tolerance before setting loan terms
• GameFi personalisation - adapt in-game economies based on Prob_Game and Prob_Gamble signals
• Marketing segmentation - allocate campaign budget toward wallets with high experience and genuine protocol engagement
• Combined screening - pair with /fraud/check at wallet-connect to gate risk and personalise simultaneously

Further Reading¶

• Web3 Behavioral User Analytics Guide - using /fraud/audit for analytics and segmentation
• Web3 User Segmentation & Behavioral Analytics for DApp Growth - segmentation strategies for DApp retention and growth

See also: Fraud Detection API | Credit Scoring API | Enterprise API Overview