---
title: "Full behavioural profile and intent prediction for a wallet address"
method: POST
path: "/fraud/audit"
tags: ["Behaviour Prediction API"]
---

# Full behavioural profile and intent prediction for a wallet address

`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.

**Subscription:** Business or Enterprise.

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

**Further reading:** [Web3 Behavioral User Analytics Guide](https://chainaware.ai/blog/chainaware-web3-behavioral-user-analytics-guide/)

## Request body

- WalletAuditRequestBody
  - `network` 'ETH' | 'BNB' | 'BASE' | 'HAQQ' | 'SOLANA', required — Blockchain network to query.
  - `walletAddress` string, required — The wallet address to profile.
  - `calculate` boolean — Boolean indicating whether to perform a full realtime recalculation

## Response `200`

Wallet behavioural profile

- WalletAuditResponse
  - `message` string — Result status message.
  - `walletAddress` string — Blockchain wallet address analyzed.
  - `status` 'Not Fraud' | 'Fraud' | 'New Address' — Fraud classification of the wallet.
  - `probabilityFraud` string — Fraud probability score between 0.00 and 1.00 returned as string for precision preservation.
  - `token` string, nullable — Optional token context associated with the wallet analysis.
  - `chain` string — Blockchain network identifier.
  - `lastChecked` string, date-time — Last time the wallet analysis was executed.
  - `forensic_details` object — Forensic indicators contributing to fraud scoring.
    - `cybercrime` string
    - `money_laundering` string
    - `number_of_malicious_contracts_created` string
    - `gas_abuse` string
    - `financial_crime` string
    - `darkweb_transactions` string
    - `reinit` string
    - `phishing_activities` string
    - `fake_kyc` string
    - `blacklist_doubt` string
    - `fake_standard_interface` string
    - `data_source` string
    - `stealing_attack` string
    - `blackmail_activities` string
    - `sanctioned` string
    - `malicious_mining_activities` string
    - `mixer` string
    - `fake_token` string
    - `honeypot_related_address` string
  - `categories` object[] — Wallet activity categories grouped by behavioral domain.
    - `Category` string
    - `Count` integer
  - `riskProfile` object[] — Balance-age weighted exposure by category and risk distribution.
    - `Category` string
    - `Balance_age` number, float
  - `segmentInfo` string — Serialized JSON containing protocol engagement flags.
  - `experience` object — Wallet experience score derived from protocol diversity and longevity.
    - `Type` string
    - `Value` integer
  - `intention` object — Predicted wallet behavioral intentions.
    - `Type` string
    - `Value` object
      - `Prob_Lend` string
      - `Prob_Trade` string
      - `Prob_Game` string
      - `Prob_NFT` string
      - `Prob_Stake_ETH` string
      - `Prob_Borrow` string
      - `Prob_Gamble` string
      - `Prob_Stake` string
      - `Prob_Yield_Farm` string
      - `Prob_Leveraged_Stake` string
      - `Prob_Leveraged_Stake_ETH` string
      - `Prob_Leveraged_Lend` string
      - `Prob_Leverage_Long_ETH` string
      - `Prob_Leverage_Long` string
  - `protocols` object[] — Protocols the wallet has interacted with.
    - `Protocol` string
    - `Count` integer
  - `userDetails` object — Core wallet metrics.
    - `wallet_age_days` integer
    - `total_balance_usd` number, float
    - `transaction_count` integer
    - `wallet_rank` integer
  - `riskCapability` integer — Wallet risk capability score.
  - `recommendation` object — Recommended investment or product fit suggestions.
    - `Type` string
    - `Value` string[]
  - `checked_times` integer — Number of times wallet analysis has been executed.
  - `createdAt` string, date-time
  - `updatedAt` string, date-time
  - `sanctionData` object[] — Sanctions intelligence associated with this wallet.
    - `category` string, nullable
    - `name` string, nullable
    - `description` string, nullable
    - `url` string, nullable
    - `isSanctioned` boolean
    - `createdAt` string, date-time
    - `updatedAt` string, date-time

## Other responses

- `400` — Bad request — missing or invalid fields in the request body
- `401` — Unauthorised — API key missing or invalid
- `404` — Wallet not found
- `429` — Rate limit exceeded
- `500` — Internal server error

---

[API](https://skmtc.dev/chainaware/apis/chainaware-enterprise-api.md) · [All operations](https://skmtc.dev/chainaware/apis/chainaware-enterprise-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/chainaware/chainaware-enterprise-api/revisions/a045ee3672fc/schema)