Sign in

v1

latestSwagger 2.02026-08-0651043.0 KB
Fraud API

Calculate rug pull probability of a contract address

Returns a rug pull probability score for a given contract address. Evaluates the contract itself, the deployer's cross-chain behavioural history, and the behaviour of associated liquidity providers.

Use this endpoint to screen liquidity pools, token contracts, or DeFi protocol contracts before your users interact with them — or to power a rug pull alert feature in your product.

ChainAware's rug pull model achieves 90% accuracy on new pools, detecting preparation patterns before a documented rug event occurs.

Subscription: Business or Enterprise.

Supported networks: ETH, BNB, BASE, HAQQ.

Further reading: Rug Pull Detector Guide

post/rug/pull-check

Request body

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

Blockchain network to query.

walletAddressstring required

The smart contract or liquidity pool address to screen. To check a wallet address instead, use /fraud/check.

Example request

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

Response

Rug pull check result

messagestring

Result status message.

contractAddressstring

Smart contract address analyzed.

pairAddressstring

Liquidity pair address on decentralized exchange.

contractCreatorAddressstring nullable

Creator address of the contract if available.

risk_scoreinteger

Internal numerical contract risk score.

risk_statusstring

Qualitative risk classification based on internal scoring.

status'Not Fraud' | 'Fraud'

Overall fraud classification of the contract.

probabilityFraudnumber float

Fraud probability score between 0.00 and 1.00.

chainstring

Blockchain network identifier.

lastCheckedstring date-time

Last analysis execution timestamp.

contractCreationTimestring date-time nullable

Smart contract deployment timestamp if available.

checked_timesinteger

Number of times this contract has been analyzed.

createdAtstring date-time

Record creation timestamp.

updatedAtstring date-time

Most recent record update timestamp.

Example response

{
  "message": "Success",
  "contractAddress": "0x91dba2cd05c8a0227b48c3e426077145d23b21df",
  "pairAddress": "0x290dd1e2e1856841b4ee4be8fd1aba51011c12e9",
  "risk_score": 2,
  "risk_status": "Low Risk",
  "risk_indicators": {
    "liquidity": 14.38,
    "market_cap": 2062,
    "is_in_dex": 1,
    "is_open_source": 1
  },
  "liquidityEvent": [
    {
      "eventType": "remove",
      "amount": 1.60228,
      "token": "wbnb",
      "tx_hash": "0xed0a492f9e8021fd74a950237703ea0047223b4bd4c032810e02734c407e624a",
      "from_address": "0x983fd7447391bae599ac38ea06cd9d60c89fbb66",
      "from_fraud_probability": 1,
      "from_fraud_status": "Fraud",
      "createdAt": "2026-01-02T11:31:22.000Z"
    }
  ],
  "status": "Fraud",
  "probabilityFraud": 0.8350795507,
  "chain": "BNB",
  "lastChecked": "2026-02-14T13:57:01.000Z",
  "forensic_details": {
    "is_open_source": 1,
    "contract_name": "PAPUToken"
  },
  "checked_times": 1,
  "createdAt": "2024-05-31T00:42:51.000Z",
  "updatedAt": "2026-03-03T10:44:35.000Z"
}