Skip to main content
POST
/
projects
/
{projectId}
/
addresses
/
scan-risk
Scan risk
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
}
'
{
  "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

LevelScoreDescription
minimal0-19No risk indicators
low20-39Normal activity with minimal alerts
medium40-59Requires manual review
high60-79High probability of suspicious activity
critical80-100Direct connection to illicit activities

Detected patterns

The analysis can identify the following risk patterns:
PatternSeverityDescription
mixingCriticalUse of mixing services to hide fund origins
peel_chainHighTransaction chains to fragment funds
structuringHighSplitting amounts to avoid reporting thresholds
round_trippingMediumFunds returning to origin after multiple hops
mass_wallet_creationMediumCoordinated creation of multiple wallets
wash_tradingMediumArtificial transactions to simulate volume
exchange_hoppingLowMovement 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
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

Risk analysis completed

success
boolean
data
object