Real-Time Solana Wallet Alerts via Webhooks: Integration Guide (2026)

Deep dive into configuring and consuming MadeOnSol wallet_tracker:event webhooks for real-time Solana wallet notifications. Covers payload structure, event types, filtering, signature verification, and retry handling.

MadeOnSol·April 15, 2026· 10 min read

Real-Time Solana Wallet Alerts via Webhooks: Integration Guide (2026)

Disclosure: This article contains affiliate links. If you sign up through them, MadeOnSol may earn a commission at no extra cost to you. This never affects our rankings, ratings, or reviews.

Building a product on Solana data?

Skip the Geyser pipeline — embed KOL flow, deployer reputation, and the all-DEX firehose over REST, WebSocket, or webhooks. The Business tier (€400/mo) is the self-serve embed license at 500k calls/day — Enterprise adds white-label & redistribution.

See Business pricing

Tools mentioned

Compare features and read reviews.

Live health scores, average ratings, and direct links on MadeOnSol.

FrogLabs Terminal

Serverless, non-custodial desktop terminal for launching and bundling Solana memecoins — private keys never leave your machine.

Jupiter Terminal

Embeddable swap widget powered by Jupiter for any Solana dApp

Foxify

Peer-to-peer perpetual futures DEX on Solana with customizable trading pairs

Build with MadeOnSol API

KOL tracking, deployer intelligence, DEX streaming, and webhooks. Free API key — 200 requests/day.

New customers try Pro free for 5 days — card, cancel anytime.

Start free

import { MadeOnSol } from "madeonsol";

// Get a free API key at madeonsol.com/pricing
const client = new MadeOnSol({ apiKey: "msk_your_key" });

const { trades } = await client.kol.feed({ limit: 10 });
const { alerts } = await client.deployer.alerts({ limit: 5 });
const { tools } = await client.tools.search({ q: "trading" });

npm install madeonsolFull API docs

Building a product on Solana data?

MadeOnSol isn't an RPC or another generic token API — it's Solana memecoin intelligence that's painful to build in-house, pulled from dual-region gRPC shred streams: sub-second from the on-chain event to your app.

Signals you'd otherwise build

KOL & smart-money flow from 1,000+ labeled wallets, deployer reputation, coordination clusters, linked-wallet entity resolution, and an all-DEX firehose.

Keep reading

More from the blog.

All Guides

Developer Tools

Build a Solana Rug-Check Telegram Bot in 10 Minutes (Free API Key)

Paste a mint into Telegram, get a scored rug-risk report back in seconds. This tutorial walks the open-source rug-check-telegram-bot starter: zero dependencies, ~150 lines of Node, a free MadeOnSol API key, and a transparent 0–100 score where every point is attributed to a named factor — mint authority, liquidity depth, LP burn, bundled launch, deployer track record.

5 minJuly 5, 2026

Developer Tools

Copy-Trade Solana KOL Wallets: Build a Paper-Trading Bot in 5 Minutes

Watch live smart-money trades on Solana and paper-trade them in real time: open a virtual position when a tracked KOL buys, close when they sell, and track PnL from the market-cap multiple. This tutorial walks the open-source kol-copytrade-bot-starter — ~300 lines, one dependency, free API key — and shows how to filter by KOL win rate, deployer tier, and multi-KOL confirmation before risking anything real.

Enjoyed this article?

Explore the live data.

Real-time KOL trades, Pump.fun deployer intel, and 1,200+ ranked Solana tools — free to explore.

Open the KOL Tracker

API reference Start free Browse all articles

Explore more

Top 10 Trading Bots Top 10 DEXs & Swaps Deployer Hunter KOL Tracker Compare Yields Solana Glossary

Setting Up Your Webhook Endpoint

The Minimal Receiver

import express from 'express';
import crypto from 'crypto';

const app = express();

// IMPORTANT: Use raw body middleware for signature verification
app.post(
  '/webhook/wallet-tracker',
  express.raw({ type: 'application/json' }),
  (req, res) => {
    // Step 1: Verify signature before doing anything else
    const signature = req.headers['x-madeonsol-signature'] as string;
    if (!isValidSignature(req.body, signature)) {
      return res.status(401).json({ error: 'Invalid signature' });
    }

    // Step 2: Acknowledge immediately — do not block on processing
    res.status(200).json({ received: true });

    // Step 3: Process asynchronously
    const payload = JSON.parse(req.body.toString());
    handleEvent(payload).catch(console.error);
  }
);

The ordering here is deliberate:

Verify the signature first — reject forged requests before touching the payload
Return 200 immediately — the API has a short delivery timeout; if you block on processing you risk timeout retries
Process asynchronously — errors in your handler do not affect delivery acknowledgement

Signature Verification

Every webhook delivery includes an x-madeonsol-signature header. It is an HMAC-SHA256 of the raw request body, signed with your webhook secret. Always verify it:

function isValidSignature(rawBody: Buffer, signature: string): boolean {
  if (!signature?.startsWith('sha256=')) return false;

  const secret = process.env.WEBHOOK_SECRET!;
  const expected = 'sha256=' + crypto
    .createHmac('sha256', secret)
    .update(rawBody)
    .digest('hex');

  // Use timing-safe comparison to prevent timing attacks
  try {
    return crypto.timingSafeEqual(
      Buffer.from(expected),
      Buffer.from(signature)
    );
  } catch {
    return false; // length mismatch — definitely not valid
  }
}

Do not skip this step in production. Anyone who can POST to your endpoint can forge events if you do not verify the signature.

Idempotent Event Processing

The API retries failed deliveries. Your handler may receive the same event ID more than once. Make your processing idempotent:

// In-memory for development; use Redis or a DB in production
const processedIds = new Set<string>();

async function handleEvent(payload: any) {
  const { event, data } = payload;

  if (event !== 'wallet_tracker:event') return;

  // Idempotency check
  if (processedIds.has(data.id)) {
    console.log(`Duplicate event ${data.id} — skipping`);
    return;
  }
  processedIds.add(data.id);

  // Route to handler based on event type
  if (data.event_type === 'swap') {
    await handleSwap(data);
  } else if (data.event_type === 'transfer') {
    await handleTransfer(data);
  }
}

Filtering Strategies

Receiving every event is not the same as using every event. Good filtering is what makes a webhook integration useful rather than overwhelming.

Field	Type	Description
`event`	string	Always `wallet_tracker:event` for this webhook type
`api_version`	string	API version — use for forward compatibility checks
`delivered_at`	ISO 8601	When the API attempted delivery (not when the tx happened)
`data`	object	The event payload — see below

Field	Type	Description
`id`	string	Unique event ID — use for deduplication
`wallet`	string	Solana public key of the tracked wallet
`wallet_label`	string \| null	Label you assigned when adding the wallet, if any
`event_type`	`"swap"` \| `"transfer"`	Type of on-chain event
`action`	`"buy"` \| `"sell"` \| null	Direction of the trade (null for transfers)
`token_mint`	string	SPL token mint address
`token_symbol`	string \| null	Token symbol (resolved from on-chain metadata)
`sol_amount`	number	SOL value of the trade
`token_amount`	number	Token quantity
`price_usd`	number \| null	USD price per token at time of swap
`signature`	string	Transaction signature
`slot`	number	Solana slot number
`timestamp`	ISO 8601	When the transaction was confirmed

Real-Time Solana Wallet Alerts via Webhooks: Integration Guide (2026)

Compare features and read reviews.

FrogLabs Terminal

Jupiter Terminal

Foxify

More from the blog.

Build a Solana Rug-Check Telegram Bot in 10 Minutes (Free API Key)

Copy-Trade Solana KOL Wallets: Build a Paper-Trading Bot in 5 Minutes

Explore the live data.

Setting Up Your Webhook Endpoint

The Minimal Receiver

Signature Verification

Idempotent Event Processing

Filtering Strategies

OKX

PancakeSwap

Pump.fun Deployer Alerts in Your Discord: Build the Bot in 5 Minutes

White-Label Solana Data: What Redistribution Rights Actually Mean for Your Product (2026)

Power Your AI Trading Agent with Solana Data: MCP vs Agent-Kit vs x402 (2026)

The Data Layer for a Telegram Trading Bot or Terminal SaaS (2026)

How Wallet Tracker Webhooks Work

The Webhook Payload Structure

Top-Level Fields

Data Fields

Swap vs Transfer Events

Swap Events (`event_type: "swap"`)

Transfer Events (`event_type: "transfer"`)

Filter by Event Type

Filter by SOL Size

Filter by Action Direction

Filter Out Stablecoins and Wrapped Tokens

Enrichment Before Filtering

Retry Semantics and Failure Handling

Testing Your Webhook Integration

Production Checklist

Compare features and read reviews.

FrogLabs Terminal

Jupiter Terminal

Foxify

More from the blog.

Build a Solana Rug-Check Telegram Bot in 10 Minutes (Free API Key)

Copy-Trade Solana KOL Wallets: Build a Paper-Trading Bot in 5 Minutes

Explore the live data.

Setting Up Your Webhook Endpoint

The Minimal Receiver

Signature Verification

Idempotent Event Processing

Filtering Strategies

OKX

PancakeSwap

Pump.fun Deployer Alerts in Your Discord: Build the Bot in 5 Minutes

White-Label Solana Data: What Redistribution Rights Actually Mean for Your Product (2026)

Power Your AI Trading Agent with Solana Data: MCP vs Agent-Kit vs x402 (2026)

The Data Layer for a Telegram Trading Bot or Terminal SaaS (2026)

How Wallet Tracker Webhooks Work

The Webhook Payload Structure

Top-Level Fields

Data Fields

Swap vs Transfer Events

Swap Events (event_type: "swap")

Transfer Events (event_type: "transfer")

Filter by Event Type

Filter by SOL Size

Filter by Action Direction

Filter Out Stablecoins and Wrapped Tokens

Enrichment Before Filtering

Retry Semantics and Failure Handling

Testing Your Webhook Integration

Production Checklist

Swap Events (`event_type: "swap"`)

Transfer Events (`event_type: "transfer"`)