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="wavy_your_api_key_here"
Step 2: Check supported chains
Verify which blockchain networks are available:
curl -H "x-api-header: ApiKey $WAVYNODE_API_KEY" \
https://api.wavynode.com/v1/chains
{
"success": true,
"data": [
{
"id": 42161,
"name": "Arbitrum",
"rpc_url": "https://arb1.arbitrum.io/rpc",
"explorer_url": "https://arbiscan.io",
"currency_symbol": "ETH",
"currency_decimals": 18
}
]
}
Step 3: Scan your first address
Submit a blockchain address for real-time risk analysis:
curl -X POST "https://api.wavynode.com/v1/projects/$PROJECT_ID/addresses/scan-risk" \
-H "Content-Type: application/json" \
-H "x-api-key: ApiKey $WAVYNODE_API_KEY" \
-d '{
"addresses": [
{
"address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
"chainId": "1"
}
],
"maxDepth": 3
}'
Step 4: Review the result
The API responds with a risk analysis for each address:
{
"success": true,
"data": {
"summary": {
"total": 1,
"completed": 1,
"skipped": 0,
"failed": 0,
"duration": 50758
},
"results": [
{
"address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
"chainId": "1",
"status": "completed",
"riskScore": 5,
"riskLevel": "minimal",
"riskReason": "Normal activity, no suspicious patterns detected",
"suspiciousActivity": false,
"patterns": []
}
]
}
}
A riskScore under 20 indicates minimal risk. Addresses scoring above 60 should be investigated.
Step 5: Check a wallet’s status
You can also check the compliance status of any wallet:
curl -H "x-api-header: ApiKey $WAVYNODE_API_KEY" \
"https://api.wavynode.com/v1/wallets/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/status?chainId=1"
{
"success": true,
"data": {
"status": "clean",
"tags": [],
"lastTxs": [],
"lastDapps": []
}
}
Next steps
