Skip to main content

​
Prerequisites

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

​
Step 1: Get your API key

Sign up on the Wavy Node dashboard and copy your API key from Project Settings. 
export WAVYNODE_API_KEY="ApiKey wavy_your_api_key_here"
export PROJECT_ID="your_project_id"

​
Step 2: Check supported chains

Verify which blockchain networks are available: 
curl -H "x-api-key: $WAVYNODE_API_KEY" \
  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 relevant address to your project so Wavy Node can monitor it and send compliance notifications: 
curl -X POST "https://api.wavynode.com/v1/projects/$PROJECT_ID/addresses" \
  -H "Content-Type: application/json" \
  -H "x-api-key: $WAVYNODE_API_KEY" \
  -d '{
    "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
    "description": "Main treasury wallet"
  }'

{
  "success": true
}
Monitored addresses automatically receive compliance notifications when they interact with risky or blacklisted wallets.

​
Step 4: Check risk analysis results

Query risk analysis results for blockchain addresses: 
curl -H "x-api-key: $WAVYNODE_API_KEY" \
  "https://api.wavynode.com/v1/projects/$PROJECT_ID/addresses/scan-risk?addresses=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045&chainId=1"

​
Step 5: Review the result

The API responds with risk analysis for each address: 
{
  "success": true,
  "data": {
    "total": 1,
    "missing": 0,
    "results": [
      {
        "analysisId": "550e8400-e29b-41d4-a716-446655440000",
        "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
        "chainId": "1",
        "riskScore": 5,
        "riskLevel": "minimal",
        "riskReason": "Normal activity, no suspicious patterns detected",
        "suspiciousActivity": false,
        "patternsDetected": [],
        "transactionsAnalyzed": 150,
        "completedAt": "2024-02-13T10:30:00Z"
      }
    ]
  }
}
A riskScore under 20 indicates minimal risk. Addresses scoring above 60 should be investigated.

​
Step 6: Download compliance reports

Retrieve auto-generated regulatory reports for your jurisdiction: 
curl -H "x-api-key: $WAVYNODE_API_KEY" \
  "https://api.wavynode.com/v1/reports?projectId=1&period=2026-01&countryCode=MX"

{
  "success": true,
  "data": [
    {
      "name": "LFPIORPI_January_2026.pdf",
      "id": "rpt_abc123",
      "created_at": "2026-02-01T00:00:00Z"
    }
  ]
}
Download a specific report: 
curl -H "x-api-key: $WAVYNODE_API_KEY" \
  "https://api.wavynode.com/v1/reports/rpt_abc123"

{
  "success": true,
  "data": {
    "name": "LFPIORPI_January_2026.pdf",
    "signedUrl": "https://storage.wavynode.com/reports/...",
    "period": "2026-01"
  }
}
Reports are available for México (MX), Colombia (CO), El Salvador (SV), and Guatemala (GT). They are generated automatically based on your project’s activity.

​
Next steps

Risk scores

Understand how risk scores are calculated.

Regulations

Explore the regulations Wavy Node covers.

Integrations

Connect your application with Wavy Node.

API Reference

Browse all available endpoints.