Quickstart

This guide gets you from zero to monitoring wallet addresses and receiving compliance alerts. By the end, you’ll have registered an address, run a risk scan, and know how to access your compliance reports.

Prerequisites

A Wavy Node account
Your API key (available in the dashboard)
A project with a projectId (found in Project Settings)

Step 1: Set up your credentials

export WAVYNODE_API_KEY="wavy_your_api_key_here"
export PROJECT_ID="your_project_id"

The x-api-key header must include the ApiKey prefix followed by your key. The correct format is:

x-api-key: ApiKey wavy_your_api_key_here

A common mistake is sending only the key without the prefix. Requests without ApiKey will be rejected with an authentication error.

Step 2: Check supported chains

Verify which blockchain networks are available:

curl -H "x-api-key: ApiKey wavy_your_api_key_here" \
  https://api.wavynode.com/v1/chains

{
  "success": true,
  "data": [
    {
      "id": 42161,
      "name": "Arbitrum",
      "rpc_url": "https://arb1.arbitrum.io/rpc",
      "active": true,
      "explorer_url": "https://arbiscan.io",
      "currency_symbol": "ETH",
      "currency_decimals": 18
    }
  ]
}

Step 3: Register an address for monitoring

Add a wallet address to your project so Wavy Node can monitor it:

curl -X POST "https://api.wavynode.com/v1/projects/$PROJECT_ID/addresses" \
  -H "Content-Type: application/json" \
  -H "x-api-key: ApiKey wavy_your_api_key_here" \
  -d '{
    "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
    "description": "Main treasury wallet",
    "foreign_user_id": "user-001"
  }'

The foreign_user_id links this wallet to a user in your system. When you set up an integration, Wavy Node uses this ID to request user data for compliance reports.

Step 4: Run a risk scan

Perform a quick risk analysis on the registered address:

curl -H "x-api-key: ApiKey wavy_your_api_key_here" \
  "https://api.wavynode.com/v1/risk/quick?address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"

{
  "success": true,
  "data": {
    "risk": 0,
    "reason": null,
    "patterns": []
  }
}

When suspicious patterns are detected, the response includes them with their severity and a human-readable message:

{
  "success": true,
  "data": {
    "risk": 60,
    "reason": null,
    "patterns": [
      {
        "name": "mixing",
        "severity": "critical",
        "involvedWallets": ["0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"],
        "involvedTxs": [],
        "message": "Address identified as mixer"
      }
    ]
  }
}

A risk score under 20 indicates minimal risk. Addresses scoring above 60 should be investigated further. For deeper analysis with date ranges and chain filtering, use the async risk analysis endpoint.

Step 5: Access compliance reports

Compliance reports are generated automatically based on your project’s activity and active legislations. Download them from the Wavy Node dashboard under Reports > Regulatory Thresholds.

Reports are available for México (MX) and Colombia (CO). Support for El Salvador (SV) and Guatemala (GT) is coming soon.

What’s next

You’ve registered an address and run your first risk scan. To receive real-time alerts and enable automatic compliance report generation, set up an integration:

Set up an integration

Connect your app to receive webhooks and serve user data for compliance.

Risk scores

Understand how risk scores are calculated.

Regulations

Explore the regulations Wavy Node covers.

API Reference

Browse all available endpoints.

Getting started

Concepts

Chains and tokens

Prerequisites

Step 1: Set up your credentials

Step 2: Check supported chains

Step 3: Register an address for monitoring

Step 4: Run a risk scan

Step 5: Access compliance reports

What’s next

Set up an integration

Risk scores

Regulations

API Reference

​Prerequisites

​Step 1: Set up your credentials

​Step 2: Check supported chains

​Step 3: Register an address for monitoring

​Step 4: Run a risk scan

​Step 5: Access compliance reports

​What’s next

Set up an integration

Risk scores

Regulations

API Reference

Prerequisites

Step 1: Set up your credentials

Step 2: Check supported chains

Step 3: Register an address for monitoring

Step 4: Run a risk scan

Step 5: Access compliance reports

What’s next