Scan risk

Analyzes the risk of one or multiple blockchain addresses in real-time, detecting suspicious patterns and generating risk scores.

POST /projects/{projectId}/addresses/scan-risk

Scan risk

cURL

curl --request POST \
  --url https://api.wavynode.com/v1/projects/{projectId}/addresses/scan-risk \
  --header 'Content-Type: application/json' \
  --header 'x-api-header: <api-key>' \
  --data '
{
  "addresses": [
    {
      "address": "<string>",
      "chainId": "<string>"
    }
  ],
  "maxDepth": 3,
  "skipExisting": true
}
'

200

{
  "success": true,
  "data": {
    "summary": {
      "total": 123,
      "completed": 123,
      "skipped": 123,
      "failed": 123,
      "duration": 123
    },
    "results": [
      {
        "address": "<string>",
        "chainId": "<string>",
        "status": "completed",
        "analysisId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "riskScore": 50,
        "riskLevel": "minimal",
        "riskReason": "<string>",
        "suspiciousActivity": true,
        "patterns": [
          "wash_trading"
        ],
        "transactionGraph": {
          "rootAddress": "<string>",
          "totalNodes": 123,
          "totalEdges": 123,
          "maxDepth": 123
        },
        "analysisEvidence": {
          "transactionsAnalyzed": 123,
          "uniqueAddressesFound": 123,
          "analysisDuration": 123
        }
      }
    ]
  }
}

This endpoint is essential for compliance with regulations such as FATF, Travel Rule, Mexico’s Fintech Law, and LFPIORPI.

Risk levels

Level	Score	Description
minimal	0-19	No risk indicators
low	20-39	Normal activity with minimal alerts
medium	40-59	Requires manual review
high	60-79	High probability of suspicious activity
critical	80-100	Direct connection to illicit activities

Detected patterns

The analysis can identify the following risk patterns:

Pattern	Severity	Description
mixing	Critical	Use of mixing services to hide fund origins
peel_chain	High	Transaction chains to fragment funds
structuring	High	Splitting amounts to avoid reporting thresholds
round_tripping	Medium	Funds returning to origin after multiple hops
mass_wallet_creation	Medium	Coordinated creation of multiple wallets
wash_trading	Medium	Artificial transactions to simulate volume
exchange_hopping	Low	Movement between multiple exchanges to evade detection

Authorizations

x-api-header · string · header · required

API key from the Wavy Node dashboard. Format: ApiKey {your-api-key}

Path Parameters

projectId · string · required

The project ID

Body

application/json

addresses · object[] · required

List of addresses to analyze (1-50)

Required array length: 1 - 50 elements

Show child attributes

maxDepth · integer · default: 3

Graph analysis depth (1-7)

Required range: 1 <= x <= 7

skipExisting · boolean · default: true

Skip addresses that have already been analyzed

Response

200

application/json

Risk analysis completed

success · boolean

data · object

Show child attributes