---
title: "Calculate fraud probability of a wallet address"
method: POST
path: "/fraud/check"
tags: ["Fraud API"]
---

# Calculate fraud probability of a wallet address

`POST /fraud/check`

Returns a fraud probability score for a given wallet address. Use this endpoint for real-time risk gating — for example, at wallet-connect to decide whether to allow or flag a user before they interact with your protocol.

**Response latency:** under 100ms.

**Subscription:** Business or Enterprise.

**Further reading:** [Fraud Detector Guide](https://chainaware.ai/blog/chainaware-fraud-detector-guide/)

## Request body

- FraudCheckRequestBody
  - `network` 'ETH' | 'BNB' | 'POLYGON' | 'TON' | 'BASE' | 'TRON' | 'HAQQ', required — Blockchain network to query.
  - `walletAddress` string, required — The wallet address to screen.
  - `calculate` boolean — Boolean indicating whether to perform a full realtime recalculation

## Response `200`

Fraud check result

- FraudCheckResponse
  - `message` string — Result status message.
  - `walletAddress` string — Blockchain wallet address analyzed.
  - `chain` string — Blockchain network identifier.
  - `status` 'Not Fraud' | 'Fraud' | 'New Address' — Risk classification of the wallet.
  - `probabilityFraud` string — Fraud probability score between 0.00 and 1.00, returned as string to preserve precision.
  - `token` string, nullable — Optional token associated with the wallet analysis.
  - `lastChecked` string, date-time — Last time the wallet fraud analysis was executed.
  - `forensic_details` object — Forensic indicators contributing to fraud classification.
    - `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
  - `checked_times` integer — Number of times this wallet has been analyzed.
  - `createdAt` string, date-time — Record creation timestamp.
  - `updatedAt` string, date-time — Last update timestamp.
  - `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)