Introduction - Wavy Node

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:

Field	Type	Required	Description
`success`	boolean	yes	Whether the request was successful
`data`	any	no	Response payload
`message`	string	no	Additional 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

Generate AI-written compliance reports from the wallet’s risk and activity.

Risk Analysis

Analyze blockchain addresses for risk and suspicious patterns. Quick sync checks or async deep analysis.

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.

​Base URL

​Authentication

​Response format

​Error example

​Available endpoints

Chains

Wallets

Risk Analysis

Reports

Addresses

API Keys

Base URL

Authentication

Response format

Error example

Available endpoints