Skip to main content
The Wavy Node API lets you analyze blockchain addresses, monitor wallets, and manage compliance workflows for your projects.

​
Base URL

https://api.wavynode.com/v1

​
Authentication

All endpoints require your API key in the x-api-key HTTP header. The value must include the ApiKey prefix: 
curl -H "x-api-key: ApiKey wavy_your_api_key_here" \
  https://api.wavynode.com/v1/chains
Get your API key from the Wavy Node dashboard.
Always include the ApiKey prefix before your key. The correct format is:
x-api-key: ApiKey wavy_...
Sending only the key without the prefix (e.g., x-api-key: wavy_...) will result in an authentication error.
Some API routes require you to provide the projectId in the URL. You can find your project’s projectId in the dashboard under Project Settings.

​
Response format

All responses use JSON with a consistent structure:
FieldTypeRequiredDescription
successbooleanyesWhether the request was successful
dataanynoResponse payload
messagestringnoAdditional context or error message

​
Error example

{
  "success": false,
  "error": "invalid_request",
  "message": "The api key is invalid"
}

​
Available endpoints

Chains

Get information about supported blockchain networks.

Wallets

Check wallet status, balance, and generate AI reports.

Scan Risk

Analyze blockchain addresses for risk and suspicious patterns.

Reports

Auto-generated regulatory compliance reports (MX, CO, SV, GT).

Addresses

Manage relevant on-chain addresses for compliance monitoring.

API Keys

Manage API keys for your projects programmatically.