Skip to main content
GET
/
projects
/
{projectId}
/
addresses
/
scan-risk
Scan risk
curl --request GET \
  --url https://api.wavynode.com/v1/projects/{projectId}/addresses/scan-risk \
  --header 'x-api-key: <api-key>'
{
  "success": true,
  "data": {
    "total": 123,
    "missing": 123,
    "results": [
      {
        "analysisId": "<string>",
        "address": "<string>",
        "chainId": "<string>",
        "riskScore": 123,
        "suspiciousActivity": true,
        "patternsDetected": 123,
        "transactionsAnalyzed": 123,
        "completedAt": "2023-11-07T05:31:56Z",
        "riskLevel": "minimal",
        "riskReason": "<string>",
        "patterns": [
          "<string>"
        ]
      }
    ],
    "missingAddresses": [
      "<string>"
    ]
  }
}
Use this endpoint to retrieve previously analyzed risk results without triggering a new scan. Results are cached and updated periodically.
For an overview of how risk scores work, see Risk scores. For detailed information about detected patterns and response examples, see Risk analysis.
Addresses with riskLevel: "critical" should be reported to the regulator per applicable regulations. See Regulations for details.

Risk scores

Learn how Wavy Node calculates risk scores and recommended actions by risk level.

Risk analysis

Technical reference with pattern weights, severity levels, and detailed examples.

Addresses

Manage relevant on-chain addresses for compliance monitoring.

Authorizations

​
x-api-key
string
header
required

Enter the full value with the ApiKey prefix. Example: ApiKey wavy_your-api-key. The prefix is required for authentication.

Path Parameters

​
projectId
string
required

The project ID

Query Parameters

​
addresses
string
required

Comma-separated list of wallet addresses to query (max 100)

​
chainId
string

Filter results by chain ID

Response

Scan risk results

​
success
boolean
​
data
object