Skip to main content
Integrations connect your application with Wavy Node. By creating an integration, you can receive real-time notifications about your users’ on-chain activity and provide Wavy Node with the necessary data to monitor their wallets.

​
How it works

Your integration is a server that exposes two endpoints that Wavy Node calls:
  1. GET /users/:userId — Wavy Node requests user data from your system for compliance checks.
  2. POST /webhook — Wavy Node sends you real-time alerts when suspicious activity is detected.
All requests from Wavy Node are signed with HMAC-SHA256 so you can verify their authenticity.

​
Getting started

There are two ways to create a new integration:

Use the template

A ready-to-go Nitro application with all required endpoints and authentication already set up.

Build from scratch

Use any framework or language. Start by setting up authentication.

​
@wavynode/utils package

We provide an npm package with utilities to simplify the integration process: 
npm install @wavynode/utils
This package includes the validateSignature function, which you need to authenticate requests from Wavy Node.

​
Next steps

Authentication

Learn how to verify requests from Wavy Node.

Endpoints

Implement the required endpoints for your integration.

API Reference

Explore the full API documentation.