Sign in

v1

latestSwagger 2.02026-08-0651043.0 KB
Behaviour Prediction API

Full behavioural profile and intent prediction for a wallet address

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.

Subscription: Business or Enterprise.

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

Further reading: Web3 Behavioral User Analytics Guide

post/fraud/audit

Request body

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

Blockchain network to query.

walletAddressstring required

The wallet address to profile.

calculateboolean

Boolean indicating whether to perform a full realtime recalculation

Example request

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

Response

Wallet behavioural profile

messagestring

Result status message.

walletAddressstring

Blockchain wallet address analyzed.

status'Not Fraud' | 'Fraud' | 'New Address'

Fraud classification of the wallet.

probabilityFraudstring

Fraud probability score between 0.00 and 1.00 returned as string for precision preservation.

tokenstring nullable

Optional token context associated with the wallet analysis.

chainstring

Blockchain network identifier.

lastCheckedstring date-time

Last time the wallet analysis was executed.

segmentInfostring

Serialized JSON containing protocol engagement flags.

riskCapabilityinteger

Wallet risk capability score.

checked_timesinteger

Number of times wallet analysis has been executed.

createdAtstring date-time
updatedAtstring date-time

Example response

{
  "message": "Success",
  "walletAddress": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
  "status": "Not Fraud",
  "probabilityFraud": "0.0421858616",
  "chain": "ETH",
  "lastChecked": "2026-02-20T14:05:17.000Z",
  "forensic_details": {
    "cybercrime": "0",
    "money_laundering": "0",
    "number_of_malicious_contracts_created": "0",
    "gas_abuse": "0",
    "financial_crime": "0",
    "darkweb_transactions": "0",
    "reinit": "0",
    "phishing_activities": "0",
    "fake_kyc": "0",
    "blacklist_doubt": "0",
    "fake_standard_interface": "0",
    "stealing_attack": "0",
    "blackmail_activities": "0",
    "sanctioned": "0",
    "malicious_mining_activities": "0",
    "mixer": "0",
    "fake_token": "0",
    "honeypot_related_address": "0"
  },
  "categories": [
    {
      "Category": "DeFi",
      "Count": 126
    }
  ],
  "riskProfile": [
    {
      "Category": "Risk_Profile",
      "Balance_age": 3
    }
  ],
  "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": "Medium",
      "Prob_Stake_ETH": "Medium",
      "Prob_Borrow": "Low",
      "Prob_Gamble": "Low",
      "Prob_Stake": "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"
    }
  },
  "protocols": [
    {
      "Protocol": "uniswap",
      "Count": 25
    }
  ],
  "userDetails": {
    "wallet_age_days": 3798,
    "total_balance_usd": 104859.49,
    "transaction_count": 19972,
    "wallet_rank": 20042
  },
  "riskCapability": 5,
  "recommendation": {
    "Type": "Recommendation",
    "Value": [
      "WBTC holding",
      "ETH holding",
      "Stablecoin lending"
    ]
  },
  "checked_times": 2135,
  "createdAt": "2023-10-12T11:46:55.000Z",
  "updatedAt": "2026-03-12T16:01:17.000Z",
  "sanctionData": [
    {
      "createdAt": "2026-03-12T16:01:18.000Z",
      "updatedAt": "2026-03-12T16:01:18.000Z"
    }
  ]
}